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PREFACE 


This manual describes the software provided for the VT15 Graphics 
Display Processor and its optional: 

a) VL04 Light Pen, 

b) LK35 Keyboard, and, 

c) VW01BP Writing Tablet and Control. 

The information provided is applicable for users employing either the 
Disk Operating System (DOS) or Advanced Monitor Software System (ADSS). 

It was assumed in the preparation of this manual that the user was 
familiar with the contents of the software manual describing the 
operating system (DOS or ADSS) being used. A list of applicable manuals 
is given at the end of Chapter 1. 

Technical changes made in this revision of the manual are indicated 
by a bar in the appropriate page margin. 
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CHAPTER 1 


INTRODUCTION 


This manual presents a detailed description of the PDP-15/VT15 Graphics Sub¬ 
program Package and is primarily concerned with those display subroutines and 
calling user programs employed to exhibit information and communicate with the 
computer. The Graphics subprograms generate display commands that allow the 
user to define display elements and direct the linking, displaying, and delet¬ 
ing of those elements. Their primary purpose is to provide a simplified means 
of using the VT15 Graphic Display device without requiring detailed familiar¬ 
ity with the hardware. 

In this manual. Graphic Routines are described in detail as follows: 


Chapter 2. 

Subpicture Routines 

3. 

Main Display File Routines 

4. 

Input Routines 

5. 

Relocating Routines 

6. 

System I/O Device Handler 

7. 

LK35 Keyboard Handler (LKA) 

8. 

VW01 Writing Tablet Handler (VWA) 

9 . 

Text Display/Edit Functions 


Subprograms which consist of Graphic Routines mentioned above are called by 
user programs written in MACRO or FORTRAN IV language. The depth of coverage 
of these routines is intended to provide a very basic understanding of the 
use of the VT15 Graphic Display system. Much useful information may be found 
in appendices following Chapter 6. 

The PDP-15 is designed with an autonomous systems structure and the VT15 fol¬ 
lows this same philosophy; it operates asynchronously from the basic processor. 
Features include a cycle time of 750 nanoseconds, a character generator (with 
64 printing characters and 4 control characters), a hardware program counter, a 
fast vector capability (1/4 inch in 1 usee), and a wide range of hardware options. 
The VT15 Graphics Software is designed for a minimum hardware configuration, as 
follows: 


PDP-15 with KSR-33 

8K Core Memory (12K required for Text Editor) 

Paper Tape High-Speed Reader/Punch 

VT15 Display Processor 

VT04 Display Console 

Two DECtape Units 
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The Graphics Software consists of a group of routines that can be called by user 
programs. Calls to these routines build display files in a portion of PDP-15 
memory that has been allocated by the calling program for such a purpose. The 
display files contain instructions and data upon which the VT15 Processor 

operates and to which its digital control and analog outputting circuits re¬ 
spond. The VT15 Processor has a set of 12 basic machine-language instructions 
which give it excellent versatility in the display of points, basic vectors, 
graphic plots, and ASCII characters. The commands contained in a main display 
file link together individual subpicture files causing the desired image to be 
displayed. Calls to other routines control the flow of the program upon the 
occurrence of light pen or push button interrupt. In this way, program paths 
can be enabled to modify the sequence of display commands and therefore modify 
the picture. 


The VT15 Graphics Software is designed to run in Bank/Page Mode and to be used 
with either FORTRAN IV or MACRO-15 programs. FORTRAN IV programs devised by 
the user will consist of standard FORTRAN IV statements and calls to routines 
within the VT15 Graphics package. Other than system software normally used 
for compilations, assemblies, loading, etc., the VT15 Graphics software does 
not require use of any other programs. 

Between DOS V2A and DOS V3A, the internal format of FORTRAN subroutine calls 
was changed. FORTRAN Version 044 and higher have the new format. Since the 
Graphics Software is called by FORTRAN, its version must match the FORTRAN 
version. Corresponding version numbers for modules of the graphics software: 

VTPRIM 004 
LTORPB 002 
TRACK 002 

The distribution of DOS V3A contains a matched set of FORTRAN and Graphics 
Software, of the new format. Under the new format, references of the form 
LARRAY are equivalent to LARRAY(l), so that these forms may be used 
interchangeably. 


The following manuals contain information useful in understanding and 
utilizing the contents of this manual. 


y 
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DOS Users 

DEC-15-ODUMA-B-D 
DEC-15-LFLMA-A-D 
DEC-15-LFEMA-A-D 

ADSS Users 


a) DOS Users Manual 

b) FORTRAN IV Language Manual 

c) FORTRAN IV Operating Environment Manual 


a) ADVANCED Monitor Software System for 
PDP-15/20/30/40 Systems 

b) FORTRAN IV Programmer Reference Manual 
(8K Systems) 

c) FORTRAN IV Language Manual 
(16K Systems) 

d) FORTRAN IV Operating Environment 
(16K Systems) 


DEC-15-MR2B-D 
DEC-15-KFZB-D 
DE C -15 - LFLMA-A-D 
DEC-15 ~ LFEMA-A-D 


Common Manuals 


a) MACRO15, Macro-Assembler Program 

b) Utility Program Manuals 

Hardware Manuals 


a) Graphic-15 Reference Manual 

b) VW01 Writing Tablet, Vol. 1 


DEC-15-LMACA-B-D 
DEC-15-YWZB-D 


DEC-15-GWSA-D 
DEC-00-H4AA-D 


The GRAPHIC-15 Reference Manual is of particular importance to the 
VT15 programmer. The manual describes the basic Graphic 15 processor 
and its interfacing arrangement with the PDP-15 computer. The informa¬ 
tion in this manual provides the user with the data needed for machine 

level programming and familiarizes the user with the operation of the 

Graphic System. 
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CHAPTER 2 


SUBPICTURE ROUTINES 

These routines allow the user to incorporate point plotting, line drawing, and 
text display in his programs with minimum effort. Calls to these routines 
together with standard FORTRAN or MACRO statements build self-contained sub¬ 
picture display files which are subscripted program arrays with executable 
display instructions® Each subpicture file contains all the display instruc¬ 
tions needed to generate a specific image on the VT04 Display console® These 
files are accessed by a Main Display File (described in Chapter 3) in any 
order or sequence during the execution of the display program® Most Subpicture 
Routines will normally be called prior to initiating execution of a Main Display 
File, thus building a library of accessible graphics (i 6 e., complete or partial 
pictorial images) from which complex images may be formed® The subpicture 
display routines and their functions are; 

LINE - Draws a line (intensified) or moves the beam (not intensified) 
from current position. (Provides for using random vector 
option, if available.) 

TEXT - Displays strings of 5/7 ASCII text previously defined by 
the user in dimensioned arrays. 

COPY - Links subpicture files (similar to subroutining) to form a 
composite display image. Provides for using hardware 
SAVE/RESTORE feature, if desired. 

PRAMTR - Sets scale, intensity, light pen sensitivity, blink, etc., 
for this subpicture, or some portion thereof. 

GRAPH - Displays specified data points in graph form. 

BLANK - Inhibits display of any copy of this subpicture. 

UNBLNK - Reverses the action of the BLANK subroutine. 

All display file storage is created by the FORTRAN user in the form of dimen¬ 
sioned integer arrays; MACRO-15 users must also allocate display file storage in 
some appropriate manner. To facilitate storage management, the first location 
of each file contains the length of the file. Limited reuse of storage is 
provided for in the Main Display File routines. 


The first location of a subpicture file, PNAME(l), contains its current length — 
this value must be set to zero before the first reference to the subpicture display 
file is made. After the first reference, the contents of PNAME(l) is set equal to 
the length of the subpicture file; this value is automatically updated by any sub¬ 
sequent calls to the subpicture display routines. (See Figure 2-1). Each display 

ELEMENT is added at the current end of the subpicture file. 
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LOCATION 

CONTENTS 

PNAME 

(6) 

-hi 

returnf 

+2 

vector command 

+ 3 

vector command 

+4 

vector command 

+ 5 

vector command 

+ 6 

DJMP* PNAME+1 


fReturn address stored by any dis¬ 
play JMS (DJMS) to this subpicture. 


Figure 2-1. Subpicture File Containing Four Vector Commands 


Since display files are generated and stored in arrays dimensioned by the user, 
they are fully accessible to the user and can be written out or read in using 
FORTRAN unformatted I/O statements. 

Storage overhead for each subpicture display file is three words? the first word 
contains the file length, the second is used for a return address, and the third 
Clast in file) contains the VT15 display command DJMP* PNAME+1. 

The procedure for generating a subpicture file such as that illustrated in 
Figure 2-1 requires some further explanation. The four calls to subroutine LINE, 
shown below, will result in such a file. This subpicture file will simply draw 
a square when accessed by the Main Display File or another subpicture file. 

DIMENSION IPNAME(10) 

IPNAME(1)=0 

CALL LINE ( 100 , 0 , 1,IPNAME(1)) 

CALL LINE (0,100,1) 

CALL LINE (-100,0,1) 

CALL LINE (0,-100,1) 


Note in the above example that storage allocation for the subpicture file was 
provided by the DIMENSION statement. Also, the first location, IPNAME(1), was 
set to zero before the first reference to it, thus indicating a new file. The 
identity of a subpicture file is the address of its first location (PNAME)and is 
given or implied, as an argument in all calls to subpicture routines. Each sub¬ 
picture file is left in displayable form so that it can be manipulated dynamically 
while being displayed. 


2-2 




Limited reuse of storage is provided for in the main display file routines RSETPT, 
REPLOT, and DELETE which are explained in Chapter 3* In this chapter, the number 
of locations required for display instructions generated by each subroutine call 
is indicated in each of the subroutine descriptions. Naturally, the total number 
of locations that can be allocated for display files is limited by the amount of 
core memory available, 

2.1 GENERAL RESTRICTIONS 

The following general restrictions apply to all subpicture routines except BLANK 
and UNBLNK. 

a. All arguments (constants or variables) must be of integer form, 

b. The variable PNAME must be set equal to zero before the first 
call referencing it, 

c. The PNAME array must be of sufficient size to contain the entire 
subpicture file (the software does not check for overflow). 

2 • 2 line subroutine 

The LINE subroutine adds to the end of the specified subpicture file the commands J 
necessary to draw a line (beam intensified) or move the beam (not intensified) 
through a specified displacement from the current beam position. 

The call statement has the form: 

CALL LINE (DELTAX,DELTAY , INT[,PNAME]) 

where the enclosing brackets [ ] indicate an optional argument. 

DELTAX represents the horizontal component of beam displacement in raster units 
and DELTAY represents the vertical component. A raster unit is the distance 
between two adjacent points along the X or Y axes, and differs in size with 

erent picture tubes. The integer variable INT indicates whether the line is 
to be intensified (INT=1, the line will be visible; INT=0 the line will not be 
visible). The variable PNAME represents the first location of this subpicture 
display file and is the name by which the subpicture is referred to in later 
manipulation. For example, if a subpicture is to start in the dimensioned array 
ILEMNT, the form is: 

CALL LINE(DELTAX,DELTAY,INT,ILEMNT (1) ) 

Each subroutine LINE call adds one command to the display file if DELTAX and 
DELTAY define one of the eight basic directions? 

VNIINCR (where VN is vector direction n, and INCR is units) 

(the exclamation operator indicates an inclusive OR function) 
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If DELTAX and DELTAY do not define one of the eight basic directions, LINE tests 
for availability of the random vector option, and, if available, adds two 
commands to the display files 


SVX1DELTAX (stroke vector, x displacement) 

SVY!DELTAY (stroke vector, y displacement) 

If not one of the eight basic directions, and if the random vector option is not 
available, LINE approximates the required line with a series of basic vectors, 
The contents of the location PNAME is incremented by the number of commands 
added to the display file 0 


In addition to the general restrictions (paragraph 2.1) outlined previously for 
subpicture routines, there is another restriction that should be considered when 
using subroutine LINE; DELTAX and DELTAY should always be signed integers with 
magnitudes not exceeding 1023. The following two statements illustrate the use 
of the LINE subroutine. 


CALL LINE (0,60,1,ILINE (1) ) 


This statement generates a display instruction to draw a vertical line 60 
raster units long. The display instruction (a basic vector) is stored at the end 
of subpicture file ILINE. 


A 


Starting point 


The following statement illustrates use of the LINE routine to draw a sloped line; 
CALL LINE(IDX,IDY,1,ILINE(1)) 


where IDX=~300 and IDY=200, we obtain the following: 



Note that the random vector option is assumed to be available (otherwise, such 
a line would be approximated). 
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2.3 TEXT SUBROUTINE 


The TEXT subroutine adds to the specified subpicture file commands necessary to 
display an identified text string - starting at the current beam position. The 
standard text font is drawn on a 10 by 14 dot matrix. Each character causes an 
increment of 14 raster units to the X position of the beam. The form is: 

CALL TEXT(STR,N[,PNAME]) 

The input variable STR identifies the dimensioned real array that contains the 
string of characters to be displayed in IOPS ASCII (Hollerith) form - five 7-bit 
characters packed in two words. The variable, N, is an integer variable that 
indicates the number of characters to be displayed in the referenced array. If 
N^0„ an ALT MODE will be inserted after the n tJl character to allow escape from 
the character mode. If N=0, ALT MODE will not be inserted in the TEXT array. 

The variable PNAME(1) is the first location of this subpicture file* as in the 
call to LINE. 


The TEXT subroutine adds three locations to the assembled display file; three is 
added to the contents of PNAME(1). 

CHARS* .+2 
DJMP .+2 
(FULL 15-BIT ADDRESS) 


NOTE 

5/7 ASCII data is loaded into the array from an 
external source (as opposed to being defined in a 
FORTRAN DATA statement), it may contain certain 
non-printing characters (such as carriage return, 
line feed, etc.) that must be allowed for when 
specifying the argument N. 


In addition to the general restrictions outlined in paragraph 2.1, the array 
referred to by TEXT must be of sufficient size to accommodate the escape char¬ 
acter that will be inserted by TEXT. Also, to ensure that the display processor 
is conditioned to escape on ALT MODE, it is necessary to start up an empty 
Main File with a call to DINIT (described in Chapter 3). When this is done, a 
display parameter word is inserted in the new Main File to enable escape on 
ALT MODE only. (The alternative is to escape on carriage return or ALT MODE, 
whichever comes first; however, this option is not selectable using Main File or 
subpicture routines.) 

The following example illustrates the manner in which TEXT to be displayed is 
set up and called: 



Setup to display "15 ASSABET RD." is 


DIMENSION ADDR(4) 

DATA ADDR(1)/5H15 AS/,ADDR(2)/5HSABET/,ADDR(3)/4H RD./ 


The call statement to display the TEXT from subpicture IPIC is: 
CALL TEXT(ADDR(1),14,IPIC(1)) 

2.4 COPY SUBROUTINE 


The COPY subroutine enables two or more subpicture display files to be linked 
together to generate a composite display image. This is accomplished by a 
display subroutining technique. COPY adds to one subpicture display file the 
commands necessary to call a second subpicture. The second subpicture begins at 
the last beam position specified by the first subpicture. The form is: 

CALL COPY(RST,PNAME1[,PNAME]) 

The variable, RST, indicates whether to save and restore display parameters 1 
when copying the specified subpicture. RST may be set to 0 or 1; 0 indicates 
no SAVE/RESTORE option and 1 indicates SAVE/RESTORE option is to be used. The 
variable PNAMEl is the first location of the subpicture to be copied. PNAME is 
the first location of the subpicture file to which display instructions generated 
by this call are to be added. 


The COPY subroutine adds three locations to the display file when the 
SAVE/RESTORE option is not specified. These three locations are as follows: 

DJMS* .+2 
DUMP .4-2 

(ADDRESS of PNAME1+1) 

However, when SAVE/RESTORE is specified, COPY adds six locations to the display 
file as follows: 

SAVE .+4 

DJMS* .+2 
DJMP .+3 

(ADDRESS Of PNAME1+1) 

(STATUS) 

RSTR .-1 


^hese parameters include (but are not limited to) scale, intensity, blink, offset, 
and rotate, which can be set by calling subroutine PRAMTR (see paragraph 2.5.1) 

For a detailed description of parameters effected by the SAVE/RSTR instruction, 
refer to GRAPHIC-15 Reference Manual (DEC-15-GWSA-D). 
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where the SAVE instruction stores the effected display parameter settings in the 
STATUS word before executing the normal sequence of COPY commands. Upon return¬ 
ing from the subpicture , these parameters are restored to their original settings 
by the RSTR instruction. The contents of PNAME is increased by three or six, as 
required. 

In addition to the general restrictions outlined in paragraph 2.1, PNAME 1 need 
not be defined when COPY is called but must be a defined subpicture when PNAME is 
displayed. The following statements 

CALL COPY {0, WINDOW(1),H0USE(1)) 

adds a call to the window subpicture file to the file identified as HOUSE. Note 
that the SAVE/RESTORE option was not specified. 

2 .5 PRAMTR SUBROUTINE 

WARNING! The display of small display files at high intensities without the SYNC 
option may damage the scope phosphor. It is recommended that SYNC be used through¬ 
out. 

The PRAMTR subroutine allows the user to add to the specified subpicture file the 
commands necessary to set up the following display features. (See DEC, Graphic-15 
Reference Manual, PDP-15 , for more detailed information.) 

Scale setting - Setting the scale has a different effect, depending on where it 
is used. If used when plotting characters or vectors, it specifies the number of 
times {0 - 15) that the unsealed vector (or stroke of a character) is to be re¬ 
peated. If used in conjunction with the graph subroutine, the scale specifies 
the coordinate distance between given points. 

Intensity Setting - The brightness of the display can be controlled in eight in¬ 
cremental steps between maximum dark and maximum light by specifying an integer 
variable or constant to represent the wanted brightness, between 0 and 7. 

Light Pen Sensitivity - The ability of the light pen to sense a "hit" can be 
controlled by means of this feature. 


_ Setting Use of this feature enables blinking of some portion or all of the 

displayed image. This feature causes characters as well as vectors to blink at a 
rate of approximately four times a second. 


j jfLE_ _ Sstting — This feature enables drawing of dashed lines and can be set 

from 0 to 3 as follows; 


Setting 


Illuminated Raster Points 
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ALL ON 

3 ON 1 OFF 

4 ON 2 OFF 
4 ON 4 OFF 



Offset Setting Since the VT15 display processor defines a square drawing area, 
a standard rectangular tube would normally have some unused area. The VT15 makes 

use of this area by means of the offset feature. When the offset is enabled, the 
absolute origin is relocated to the lower right-hand corner of the normal display 
area. This small area (approximately 9-1/2 x 1-1/2 in.) can be used for light 
buttons, special figures, etc., without disturbing the normal graphics area. 

^^ate Setting - This feature allows the displayed image to be rotated 90 degrees 
in the counterclockwise direction or returned to its normal orientation if it is 
currently rotated. This could be useful for labeling graphs on the vertical axis 
or for any of a number of other applications. 

Getting - The ability to set the Name Register is required to iden¬ 
tify the location of light pen hits when using subroutine LTORPB. However, it is 
a feature which, when used at the programmer’s discretion, can be helpful in 
many other applications. Once set, it retains its value until set to a different 
value. 

Sync_^eature - This feature can be used to avoid phospher burnout when displaying 
files that require 32 milliseconds or less for execution. The display will halt 
and remain stopped until a sync pulse, derived from the local power main, enables 
execution to resume. This essentially locks execution of the display file to the 
power line frequency, which eliminates a visible swimming effect on the CRT. 

By using the PRAMTR call statement, more than one feature (each with its corres¬ 
ponding settings) may be specified, using the following technique: 

1. Add together the integer code numbers that identify the selected 
features and assign this value to the variable FEATR. For example: 

For scale (1) and Intensity (2), FEATR will have the value 3. 

2. List the desired settings, as arguments, in ascending order accord¬ 
ing to the values of the numeric assigned to their corresponding 
features (the argument list 3,2,6 would specify a value of 2 for 
scale (feature 1) and of 6 for Intensity (feature 2)). The general 
call statement form is: 

(a) One feature - CALL PRAMTR(FEATR,VALUE[,PNAME]) 

(b) More than one feature and setting - 

CALL PRAMTR(FEATR(S),VALUE1,VALUE2...[,PNAME]) 

The variable FEATR represents the display feature being set. The variable 

VALUE is the value to which FEATR is set. (See Table 2.1 for FEATR and VALUE 

settings.) PNAME is the first location of this subpicture file. 
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The PRAMTR subroutine adds from one to four commands to the display file, depend¬ 
ing on the type of argument list used. 1 The number of commands added to the 
file is added to the contents of location PNAME. 


Table 2.1 Display Parameter Settings 


1 Parameter 

Integer Code 
for FEATR 

Possible Settings !J 

1 Scale 

1 

0 (Low) to 15 (High) |j 

1 Intensity 

2 

0 (Low) to 7 (High) | 

j Light Pen 

4 

0 (OFF) and 1 (ON) | 

j Blink 

8 

0 (OFF) and 1 (ON) 1 

j Dash 

16 

0 (Solid) to 3 (Finest dash) I 

l Offset 

32 

0 (OFF) and 1 (ON) p 

| Rotate 

64 

1 (CCW 90°) and 1 

0 (Return CW 90°) 

| Name Reg. 

128 

0 (Lowest) to 127 (Highest) 1 

| Sync 

256 

0 (OFF) and 1 (ON) j 


Note: The abbreviation CCW = counterclockwise 

CW = clockwise 


In addition to the general restrictions, the PRAMTR subroutine must be used with 
care, since the setting given is in effect until explicitly changed. Thus, if 
the blink is turned on at the beginning of a subpicture, it must be turned off 
at the end, otherwise the entire display image will blink (unless, of course, the 
SAVE/RESTORE option is used in calls to this subpicture). 

The following single feature statement: 

CALL PRAMTR (2,7,HOUSE(1)) 

specifies an intensity level of 7, for the subpicture display file starting at the 
first location of array HOUSE. The following multiple-feature statement: 

CALL PRAMTR (SCALE+INT+LPEN,0,4,1,IN(1)) 


and -^^ ensit Y settings, when combined, generate only one display command, 
xght pen, blink, offset, and rotate, when combined, generate only one display 
command Sync and dash features, when combined, generate only one display com¬ 
mand. Setting the Name Register generates one command. 
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specifies the values 0 and 4 for scale and intensity, and turns on the light pen 
sensitivity. Appropriate display commands are added to the file that begins with 
the first location of array IN. 


2.6 GRAPH SUBROUTINE 


The GRAPH subroutine adds to the specified subpicture file the commands 
necessary to display in graph form the identified set of data points. One 
coordinate is sequentially set to the value of each data point, the other 
coordinate is then automatically incremented (in the current scale), leaving 
the beam positioned one increment past the end of the graph. Note that axes 
and labeling must be provided separately. The call statement form is; 

CALL GRAPH (DTA,N,A[’, PNAME]) 

DTA represents an INTEGER array that contains the set of data points, one per 
word, in the range 0 to 1023. The variable N indicates the number of data 
points to be displayed. The variable A indicates which axis to increment, where 
A is set to either 0 or 1. (A=0 specifies incrementing the X axis and setting 

Y to data values; A=1 specifies incrementing the Y axis and setting X to data 
values.) The variable PNAME specifies the first location of the subpicture 
file to which the generated display commands are to be added. 

The GRAPH subroutine adds to the subpicture file a number of graph-plot commands 
equal to the number of entries in the data set, as shown below. The number of 
commands added to the file is added to the contents of PNAME. * 

GXIVAL1 GYIVAL1 

GXIVAL2 GYIVAL2 


or 

GXiVALn GYIVALn 

One way to summarize the discussion up to this point is to review a program , 
(Figure 2-2 Sine Wave Program Example) which illustrates the use of GRAPH and 
other subroutines. 


2 ° 7 BLANK SUBROUTINE 

The BLANK subroutine is used to prevent the displaying of any copy of the 
specified subpicture. However, the display file length is not changed. The form 
is: 


CALL BLANK (PNAME) 


where the variable PNAME is the subpicture to be blanked. 
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c 

C ARRAY INITALIZATION 

INTEGER SINWV(300) , YC200) 

DIMENSION TITLC10),MAINFLC20) 

DATA TITL<i),TITLC2), TITL(3),TITL(4)/5HTHXS , 
1 5 HIS A ,5HSINE ,4HWAVE/ 

C 

C SET UP INTEGER ARRAY OF VALUES TO BE PLOTTED® 

C 

10 X=0 

DO 20 1=1,200 

Y(I)=IFIX(SIN(X)*256®)+512 
X=X+ 9 062S 
20 CONTINUE 

C 

C SET UP SUBPICTURE TO PLOT THOSE VALUES® 

C 

SINWV(1) = 0 

CALL PRAMTRC3,0,7,SINWV(1)) 

CALL LI NEC 1000,0,1) 

CALL LI NEC-1000,0,0) 

CALL LINE (0,250,0) 

CALL LINE(0,-500,I) 

CALL LINE (0,250,0) 

CALL PRAMTR (1,4) 

CALL GRAPH (Y(l),100,0) 

CALL GRAPH (Y(101),100,0,SINWVd)) 

C 

C SET UP MAIN FILE TO DISPLAY THE GRAPH® 

C (MAIN FILE CALLS BELOW, DESCRIBED IN CHPT® 3) 

C 

MAINFL(1)=0 

CALL DI NIT (MAI NFL(1)) 

CALL SETPT (10,512) 

CALL PLOT (0,0,SINWV(1)) 

CALL SETPT (100,100) 

CALL PLOT (2,1,1) 

CALL PLOT (3,TITL(1>,19) 

CALL DCLOSE 

PAUSE 

STOP 

END 


Figure 2-2. Sine Wave Program Example 
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PNAME 

LENGTH 

+1 

Return Add. 

i +2 

First Display Inst. 

: 

DJMP* PNAME+1 


Figure 2-3. Operation of BLANK/UNBLANK Subroutine 


In figure 2-4 the command in location PNAME+2 (the first executable command in 
the subpicture file) is interchanged with the DJMP* PNAME+1 located at the end of 
the subpicture file. PNAME must be a defined subpicture file (BLANK has no mean¬ 
ing as the first call referring to PNAME). The subpicture files should not be 
modified while BLANKed. The following example would prevent the subpicture dis¬ 
play file starting at the first location of array IPIC from being displayed. 

CALL BLANK (IPIC(l)) 

2 * 8 UNBLNK SUBROUTINE 

The UNBLNK subroutine reverses the action of the BLANK subroutine, allowing a 
previously BLANKed subpicture to be displayed. The form is, 

CALL UNBLNK (PNAME) 

where the variable PNAME is the subpicture to be UNBLNKed. The command in' the 
last location of the subpicture file (placed there by a call to BLANK) is inter¬ 
changed with the DJMP* in location PNAME+2. If the referenced subpicture is not 
already BLANKed, UNBLNK will return without changing the file. 

The following statement will enable the previously BLANKed subpicture IPIC to 
be displayed. 


CALL UNBLNK (IPIC(l)) 

2.9 CIRCLE SUBROUTINE 

The CIRCLE Subroutine is provided as a FORTRAN source, and must be compiled before 
use. The CIRCLE Subroutine enables the user to construct approximations of arcs 
and circles as subpictures by specifying the length of a series of chords and the 
start and stop points of the arc or circle to be constructed. 


2-12 



The form of the FORTRAN call for the CIRCLE subroutine is: 


CALL CIRCLE (R,THETA,GAMMA,DEG,PNAME) 
where the call variables in floating point except PNAME, are defined as: 

1) R, the radius, in raster units, of the circle to be constructed* 

2) THETA , the start of a constructed arc expressed in degrees from 
the X-Axis, rotating counterclockwise about the center of the 
screen. 

3) GAMMA, the end point of a constructed arc, expressed in degrees, 
rotating counterclockwise about the center of the screen. 

4) DEG * the chord length expressed in degrees. 

5) PNAME , the name of the location at which the CIRCLE subroutine 
will start the new subpicture array. 

In DOS V3A, the calling arguments remain the same. However, at the conclusion 
of the arc or circle, the beam is returned to the center of the circle, not 
left at the edge as in DOS V2A. 

The call to the CIRCLE subroutine has no effect if ang is less than 0.001 degrees 
(absolute) or if r is less than one raster unit. The difference between gamma and 
theta is reduced modulo 360, and both are measured counter-clockwise from theta to 
gamma. If ang is negative, circles are drawn clockwise from theta to gamma. A full 
circle is frawn if theta and gamma are within 0.001 degrees (modulo 360 degrees). 

The maximum number of polygon sides allowed is 360, even at the expense of not com¬ 
pleting the requested circle or arc. It is possible for famma to be less than theta. 
If the user wishes, for example, he can draw an arc counter-clockwise from 20 degrees 
around to 10 degrees. Note that the previous contents of the display file ISUB are 
destroyed by this call. 

The MACRO form of the CIRCLE subroutine using the same variable representations as 
above is: 


.GLOBL 

CIRCLE 

JMS 

CIRCLE 

JMP 

.+6 

. DSA 

R 

. DSA 

THETA 

.DSA 

GAMMA 

.DSA 

DEG 

.DSA 

PNAME 


NOTE 

CIRCLE Subroutines require the W15 arbitrary vector 
hardware option. 



2.10 ROTATE SUBROUTINE 


The ROTATE subroutine is provided as a FORTRAN source, and must be compiled before 
use. The ROTATE subroutine enables the user to plot three-dimensional figures from 
basic two-dimensioned figures. Displayed items may be rotated about a specified 
axis through a designated angle of rotation. This subroutine achieves the rotation 
effect by modifying the users array. 

A single call to the ROTATE subroutine can effect a rotation about one or more 
of the X, Y, or Z-axes. The rotation of a display about any other axis requires 
more than one call to be made to the subroutine. 

The ROTATE subroutine utilizes the same left-handed system that is used through¬ 
out the graphics software, that is: 


a) X, horizontal movement, positive to the right; 

b) Y, vertical movement, positive is up; 

c) Z, axis into the display screen (positive movement) 

The setpoint defines the origin of the axis of rotation. 


CAUTION 

The ROTATE subroutine should be used carefully, particularly 
when rotating large figures, or off-center origins. 

If, during rotation, the end-point of a line of the rotating figure passes 
off screen, part or all of the figure may be lost. It is good practice in 
rotating large figures to save the original buffer before calling ROTATE. 

The following restrictions must be observed: 

1) The values in the user’s rotation arrays must be in floating point 
format. 

2) The user must calculate the sine and cosine of the angle of 
rotation before he calls ROTATE. 

3) The user must change integers into floating point numbers, and 
make the correct calls for displaying the rotated figure. 


The FORTRAN and MACRO formats for calls to ROTATE are: 


FORTRAN: 

CALL ROTATE(ISTR,IA,IB,IC,X, Y, E, SINA, CSA) 
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MACRO: 


.GLOBL 

ROTATE 

JMS 

ROTATE 

JMP 

. + 12 

. DSA 

ISTR 

. DSA 

IA 

.DSA 

IB 

.DSA 

IC 

.DSA 

X 

.DSA 

Y 

.DSA 

Z 

.DSA 

SINA 

.DSA 

CSA 



where the input variables are defined as: 

1. ISTR, the array length. 

2 * IA f specifies whether rotation about the Z axis is desired 
If IA=1, rotation will occur about the Z axis. 

If IA=$f, there will be no rotation about the X-axis 

3. IB, specifies whether rotation about the Y-axis is desired. 

IB=1 indicates rotation is desired, as with IA. 

4. IC, specifies whether rotation about the X-axis is desired. 

indicates rotation is desired, as with IA. 

5. X, the name of the X array. 

6. Y, the name of the Y array 

7. Z, the name of the Z array. 

8. SINA, the sine of the angle of rotation. 

9. CSA, the cosine of the angle of rotation. 
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CHAPTER 3 


MAIN DISPLAY FILE ROUTINES 


Calls to Main File routines together with standard FORTRAN IV statements will, 
when run, build a "Main Display File" in a portion of the PDP-15 memory ! 

that has been allocated by the calling program. The commands contained in 
this file link together individual subpicture display files causing the desired 
image to be displayed. 

These routines are used to generate a Main Display File to which the display 
processor is directed when initiating a display, and which is presumed to be 
calling upon the subpicture files generated with the routines described in 
Chapter 2. As is the case with subpicture files, storage used for the main file 
is supplied by the calling FORTRAN program as a dimensioned array. This array 
is identified by only one call to the initializing routine (DINIT) and is implicit 
in all other calls (which assume that reference is made to the storage identified 
by DINIT). These call statements are concerned, however, with the identification 
of each entry to the main display file. Thus most main file routines have as an 
optional argument the location of the display code generated by that particular 
call, which provides a "handle" to a particular graphic entity. This supplies the 
flexibility required to build and modify a display file in an interactive environ¬ 
ment, and enables the user to perform limited storage management. The main dis¬ 
play file routines and their functions are; 

DINIT - initializes and starts the display via device number 
(.DAT SLOT) 10 

DCLOSE - stops the display and leaves the main file in a form 
such that it can be called as a subpicture file. 

SETPT — sets absolute starting point of display. (Point not 

intensified.) 

PLOT - displays pre-defined but not necessarily complete sub¬ 
pictures, individual LINEs, or ASCII text; also used 
to define display parameters. 

DELETE - deletes named subpicture file from main display file. 

REPLOT - similar to PLOT, but permits reuse of previously 
defined areas in the main file. 

RSETPT - similar to SETPT, but permits reuse of previously 
defined areas in the main file. 
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When returned from PLOT or SETPT, CNAME 1 contains a count of the instructions 
generated by that particular call in the high-order 3 bits* REPLOT and RSETPT 
use this count to determine whether the required number of locations is avail- 
able 0 If there are not enough locations available, these routines check to see 
j if there are enough contiguous locations in the main display file containing 
display NOP 8 s to satisfy the requirement B If the requirement is not satisfied, 
the function fails, an indicator to that effect is returned, and the display file 
is not changed» If the requirement is satisfied, the new group of instructions 
is inserted into the file along with enough display NOP s s, if necessary, to match 
the size of the original group of instructions, and a logical success indicator 
is returned„ 

The DELETE function operates in a similar fashion, checking for a legal instruc¬ 
tion count in the high-order 3 bits of CNAME® If the instruction count is zero, 

| the function fails, an indicator to that effect is returned, and the main display 
file is not changed® Otherwise, the number of instructions indicated (by the 
high-order 3 bits of CNAME) are replaced with display NOP 8 s and a logical success 
indicator is returned® 

An exception to this file management technique is when random direction lines 
must be approximated for calls to PLOT. In this case, the count returned in the 
high order bits of CNAME is set equal to 7 (this count is less than 7 for all 
other calls). The instructions for line approximation are added to the display 
file in the following format, where the actual count of instructions added to 
the file (plus 2) is stored in CNAME+1. 

SKP 

(C0UNT=N+2) 

VI 

V2 

VN 


This difference in file management is invisible to the user since REPLOT and 
DELETE still operate the same externally. 

Smaller groups of instructions can be packed into memory formerly required by a 
larger group. CNAME must be manipulated to accomplish this, and caution is ad¬ 
vised in following this procedure. 

As an example, assume that a previous call to PLOT has generated six instructions 

1 The optional output argument (CNAME) which is returned from PLOT and SETPT is 
a pointer to the display code generated by that call. It is a required input 
argument to subroutines REPLOT and RSETPT that permit reuse of locations in the 
main display file. It is also a required input to subroutine DELETE. 
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starting with the tenth location of the integer array IBUF. Also assume 
that CNAME was requested as an output argument of that call to PLOT, and is 
assigned to the variable IPLOT. When returned from the call to PLOT, IPLOT 
would point to IBUF(10), and the three high—order bits would equal six (the 
number of display commands inserted in the file). 

If at a later time you wish to reuse these locations by inserting two 
successive calls to REPLOT (each of which generates three display commands), 
you can do so as follows; 

CALL REPLOT (....,IPLOT) 

IPLOT=(IPLOT*8/8)+3 
CALL REPLOT IPLOT) 

In the second statement of the above sequence, the portion in parenthesis 
zeroes out the count in the high order three bits of IPLOT. (When this count 
is zero, REPLOT simply checks to see if enough DNOP'ed locations are available 
to satisfy the requirement.) Three is then added so that IPLOT now points to 
the first free location. It should be emphasized that simply adding three to 
the value of IPLOT is not satisfactory, since the count would not be valid for 
the second REPLOT (in fact, an additional three DNOP's would be added to the 
file to satisfy the original count of six). Therefore, it is imperative to 
know the exact number of locations available when using this technique, and 
to proceed with caution. 

3-1 DINIT (DISPLAY INITIALIZE) SUBROUTINE 

The DINIT subroutine initializes the display via device number (.DAT SLOT) 10. 
The VT15 device handler (VTA) must be associated with .DAT slot 10 as DINIT 
contains .IODEV 10, which causes the device handler associated with .DAT slot 
10 to be loaded. DINIT can be used to set up for a new display main file, to 

start up an old one, or to start up any previously defined subpicture as the 
current main file. The call statement form is; 

CALL DINIT (MAINFL(1)) 

MAINFL is the first location of the Main Display file. Like PNAME, it is an 
element of a dimensioned integer array. Location MAINFL contains the length 
of the Main Display File. This is updated by all main file routines. 

Subroutine DINIT stores a DUMP* MAINFL+1 at the end of the main file, inserts 
the address of MAINFL+2 into MAINFL+1, initializes the display, and starts 
the display running at MAINFL+2. 

Certain restrictions must be noted when using DINIT. If a new display file is 
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being formed, location MAINFL must contain zero? if this is a previously defined 
file, location MAINFL contains the file length and must not be altered. Suffi¬ 
cient storage must follow MAINFL to accommodate the main display file that is to 
be generated. Only one main display file can be running at a time. 

NOTE 

When a new main display file is being initialized, DINIT inserts a dis¬ 
play parameter word to turn off blink, offset, rotate and light pen, 
and to enable character string escape on ALT MODE (175g). To change 
the initial settings for blink, offset, rotate, and light pen, or to 
ensure that other display features (i.e., scale, intensity, dash, 
name register, and sync) are .initially set as desired, the calling 
program should contain a PRAMTR type call to PLOT (described in para¬ 
graph 3.4.3) following the call to DINIT. 

The following statement initializes the execution of the Main Display File start¬ 
ing at the first location of array MAINFL. 


CALL DINIT (MAINFL(1)) 

3.2 DCLOSE (DISPLAY TERMINATE) SUBROUTINE 


The DCLOSE subroutine is used to stop the display. DCLOSE also leaves the cur¬ 
rent main file in displayable form such that it can later be called as a sub¬ 
picture file or restarted as a main file. The call statement form is simply: 

CALL DCLOSE 

3.3 SETPT (SET POINT) SUBROUTINE 


The SETPT subroutine is used to locate the beam on the display surface in abso¬ 
lute display coordinates (raster units). The beam is not intensified with this 
call. The call statement form is: 

CALL SETPT (X,Y[,CNAME]) 

where the variable X represents the horizontal coordinate of beam location and Y 
represents the vertical coordinate of beam location. The variable CNAME is a 
pointer to the first location of the display commands generated by this call. 
SETPT adds two commands to the main file, as follows: 

PY! Y 
PX! X 

Two is added to the contents of location MAINFL. The location PYIY is stored in 
CNAME (if given). 


The variables X and Y must be positive integers and their values must not exceed 
1023. A call to SETPT causes the beam to be given an absolute location, as op¬ 
posed to a relative displacement. This action effectively severs any following 
parts of the display from any preceding parts; if a section of the display 

is completely defined in terms of relative vectors, then its location on the 
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display surface depends on where the beam was initially located; and it can be 
made to move as a unit by changing the initial setting. Giving the beam an 
absolute location disregards any previous motion and serves as a new reference 
point in the display. 

CNAME is an optional output of this subroutine. Use of the same variable name 
as one used in a previous call will destroy the previous contents. The following 
statement establishes an absolute beam position with display coordinates X = 10, 

Y = 10 . 


CALL SETPT (10,10) 
3.4 PLOT SUBROUTINE 


The PLOT subroutine is the prime active agent in the generation of the Main Dis¬ 
play File. There are four forms of calls corresponding to the four subpicture 
routines, COPY, LINE, PRAMTR, and TEXT. These calls are used to display pre¬ 
defined (but not necessarily complete) subpictures and individual lines or text 
strings, and to introduce appropriate display control commands. In all cases, 
the requested display or control function is identified as a separate entity and 
may be manipulated independently of the rest of the display. The first entry in 
the argument list defines the type of call to PLOT as follows; 


FIRST ARG TYPE OF PLOT 


COPY 

LINE 

PRAMTR 

TEXT 


3.4.1 Plot a Subpicture (COPY) 


The call statement form is; 


0 

1 

2 

3 


CALL PLOT (0,RST,PNAME[,CNAME]) 


where the value 0 indicates this is a COPY type call to PLOT. RST is the 
indicator for the SAVE/RESTORE option (same as COPY). PNAME is the name (first 

location) of the subpicture to be displayed. 

CNAME is an optional output argument that will contain a pointer to the first 
location of the group of display commands generated by this call. The number of 
commands added to the display file is added to the contents of MAINFL(1). In general 
the same restrictions apply as for the COPY subroutine. Again, multiple use of 
the same variable CNAME will destroy previous contents. The following example 
illustrates use of a COPY type call to PLOT; 
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CALL PLOT (COPI , 0 ,HOUSE (1) ,MAIN) 


In this example, COPI has the integer value 0 ; the next argument ( 0 ) is the 
indicator for the SAVE/RESTORE option; HOUSE identifies the subpicture file to 
be displayed; and MAIN is an optional output argument by which the group of dis~ 
play instructions inserted for this call may be referenced. 

3.4.2 Plot a Line (or Reposition the Beam ) 

The call statement form is: 

CALL PLOT (1,DELTAX,DELTAY,INT[,CNAME]) 

This type of PLOT is basically the same as the LINE subpicture routine, except 
for the first argument which defines this as a line type call to PLOT. The 
variable CNAME is an optional output argument and will contain a pointer to the 
first location of the group of display commands generated by this call. The 
number of commands added to the display file is added to the contents of MAINFL. 
The location of the first display command is stored in CNAME (if given). 

As in SETPT, CNAME is an output variable and multiple use of the same variable 
name will destroy previous contents. Otherwise, the same general restrictions 
apply as for the LINE subpicture routine. The following example illustrates a 
LINE type call to PLOT. 

CALL PLOT (LYNE, 1000 , 100 ,0N,IEDGE (1)) 

where LYNE and ON have assigned values of 1 and IEDGE(1) is a display identifier 
to be used for later reference to this LINE. 

3.4.3 Plot a Control Command (PRAMTR) 

The call statement form is; 

CALL PLOT (2,FEATR,VALUE[,CNAME]) 

where FEATR and VALUE must be specified in the same manner as for PRAMTR sub™ 
picture calls. Also, as with the PRAMTR call, multiple features can be specified 
in a single PLOT call of the following form; 

CALL PLOT ( 2 , FEATRs , VALUE 1, VALUE 2, . . . ,VALUEn [, CNAME ] ) 

The number of commands added to the display file is added to the contents of 
MAINFL. The location of the first command is stored in CNAME (if given). The 
same general restrictions apply as for the PRAMTR subpicture routine. The 



following example illustrates the use of this type of PLOT to set the BLINK 
feature in a Main File. 

CALL PLOT (2,8,1) 

The multiple-feature statement 

CALL PLOT (PRAM,SCALE+INT+LPEN,0,4,1,IN) 

establishes values 0 and 4 for display features SCALE and INT, and turns the 
light pen sensitivity on. The variable IN is supplied for the optional CNAME 
output argument. (PRAM=2, to specify a PRAMTR type call to PLOT.) 

3.4.4 Plot a Text String (TEXT) 

The call statement form is: 

CALL PLOT (3,STR,N[,CNAME]) 

This type of call to PLOT is essentially the same as that for the TEXT subpicture 
routine, except for the first argument which defines this as a TEXT type call to 
PLOT. The number of commands added to the display file is added to the contents 
of MAINFL. The location of the first generated display command is returned in 
CNAME (if given). The same restrictions apply as for the TEXT subroutine. The 
following example illustrates the use of the TEXT type call to PLOT 

CALL PLOT (3,STRING,15,SAVNAM) 

where STRING contains the 15 characters to be displayed, and SAVNAM will contain 
a pointer to the group of display commands inserted by this call. 

3.5 DELETE FUNCTION 

The DELETE function is used to delete from the Main Display File any display 
entity formed by a single call to a main file routine and assigned to CNAME. If 
CNAME does not contain a legal instruction count (1-7), the DELETE fails and has 
no effect on the display file. The function and call statement forms are: 

I = DELETE (CNAME) 
or 

CALL DELETE (CNAME) 

The input variable CNAME is the location of the group of display commands to be 
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deleted. In the function form (1=), the output variable I is a Boolean success 
indicator; TRUE indicates a successful deletion, FALSE indicates an unsuccessful 
deletion. CNAME is checked to see if it contains a legal instruction count in 
high-order bits. If it does, all commands in this group are replaced by display 
NOP's (DNOPs); otherwise, no action is taken. 

The examples 


CALL ■ DELETE (NAME(2)) 


deletes from the*Main Display File the display entity whose first command is 
pointed at or identified by the second element of array NAME. 

3.6 REPLOT FUNCTION 


The function REPLOT allows use to be made of previously defined locations in the 
Main Display File. This can serve two purposes; (1) to reuse locations freed by 
DELETE, and (2) to change an existing group of display commands. REPLOT checks 
whether the group being inserted is longer than the space pointed at by CNAME, if 
it is, REPLOT then checks to see if there are enough DNOPed locations following 
the group to be overlaid. If there still are not sufficient locations available, 
the REPLOT fails and the display file is not affected. By manipulating CNAME, 
smaller groups can be packed into the space formerly used by a larger group. For 

example, up to three control commands could be inserted into the space left by 

a DELETEd copy group. There are four forms of call to REPLOT, each of which is 

similar to the corresponding call to PLOT (.Paragraph 3.4). 

The first entry in the argument list defines the type of call to REPLOT as follows: 


FIRST ARG 


TYPE OF REPLOT 


0 

1 

2 

3 


COPY 

LINE 

PRAMTR 

TEXT 


It is important to note that while CNAME is an optional output of PLOT it is a 
required input of REPLOT since it identifies the locations to be modified in the 
Main Display File. It also must be recognized that CNAME must have been given as 
an argument to a PLOT call for it to be available for REPLOT. 

Since all of the REPLOT functions are similar to corresponding calls to PLOT, 
only the COPY type REPLOT is described as an example. The call statement forms 
for a COPY type REPLOT are: 
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I = REPLOT (0, RS T, PNAME,CNAME) 
or 

CALL REPLOT ( 0 , RST,PNAME,CNAME) 

The input variables are the same as in the corresponding call to PLOT, except 
CNAME, which points to the first location of a block in which to store the dis¬ 
play commands generated. The output variable I is a logical success indicators 
TRUE indicates that the REPLOT was successful, and FALSE indicates that there 
was not enough room at the location pointed to by CNAME. It should be emphasized 
that if the above form is used, both I and REPLOT must be declared as LOGICAL in 
a type statement. 

The COPY type REPLOT checks whether CNAME points to a large enough block of 
locations; no action is taken if the block is not large enough. Otherwise, 

REPLOT inserts the necessary commands starting at the location pointed to by 
CNAME, and inserts DNOP's in any remaining locations within the block. The same 
general restrictions apply as for the corresponding call to PLOT. The following 
example illustrates a COPY type call to REPLOT: 

CALL REPLOT (0,IRST,SLIDE(M),NAME) 

where 0 indicates that this is a COPY type call. IRST is equal to zero to 
indicate no SAVE/RESTORE option, M represents the first location of the sub¬ 
picture display file (in array SLIDE) and NAME identifies the first location in 
the display file into which this group of commands is to be inserted. 


3.7 RSETPT FUNCTION 

Like SETPT, the function RSETPT permits absolute beam locations to be defined; 
it can be used in the same manner as REPLOT to reuse any deleted locations or 
to change any existing group of commands. The same checking of needed space 
versus available space is done by RSETPT as in REPLOT. 

The call statement forms are; 

I = RSETPT (X,Y,CNAME) 


or 


CALL RSETPT (X,Y,CNAME) 
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The variable X represents the horizontal coordinate of beam location; Y repre¬ 
sents the vertical coordinate of beam location. CNAME is an input argument 
that points to the first location of a block in which to store the display 
commands that are generated. If the function form (1=) is used with RSETPT, 
both I and RSETPT must be declared as LOGICAL in a type statement. RSETPT first 
checks whether CNAME points to a large-enough block of locations; no action is 
taken if the block is not large enough. Otherwise, RSETPT inserts two position¬ 
ing commands at the location pointed to by CNAME: 

PY1 Y 

PXIX 


RSETPT also inserts DNOPs in any remaining locations belonging to a former command 
group at this address. The following example illustrates the use of a call to 
RSETPT: 


CALL RSETPT (10,10,NAME) 


where the value of 10 is assigned to the X and Y coordinates and NAME identifies 
the starting location of a block within the display file into which the position¬ 
ing commands are to be inserted. 
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CHAPTER 4 


INPUT ROUTINES 

Input routines enable the user (through his program) to deal with display con¬ 
sole interaction using the light pen and pushbuttons. Routine LTORPB can inform 
the user whether there has been a light pen or pushbutton action and, if so, 
return the appropriate information that is required. The user program is not 
(logically) interrupted when such action occurs. The light pen or pushbutton 
action at the console merely causes an indicator to be set in the corresponding 
routine. This may affect the user's flow of control at his discretion. The 
light pen tracking routine (TRACK) provides a somewhat different use of the 
light pen, allowing the user to control input and generation of graphics. 

4 * 1 LTORPB FUNCTION 

The function LTORPB is used to determine whether a light pen or pushbutton hit 
has occurred. If it has not, the function returns an indicator to this effect. 
If a hit has occurred, the logical (contents of name register) and physical 
(Y and X raster coordinates) location of the light pen and the status of the 
pushbutton box are returned as well as the indicator that a hit has occurred. 

For example, this routine may be used as a switch in a FORTRAN logical IF state¬ 
ment (see example below). The IF statement could branch to itself if no hit has 
occurred, or to the user’s light pen hit processing code if a hit has occurred. 

The function statement form is: 

I = LTORPB (IX,IY,NAMR,PB,IWICH) 

LTORPB and the variables I and PB must be declared logical in a type statement. 

The output variable I is a logical success indicator; TRUE indicates that a light 
pen or pushbutton hit has occurred, and FALSE indicates no light pen hit has 
occurred. It should be emphasized that if I is FALSE, IX, IY, NAMR, and PB 
have no meaning. 

The variable IX is the horizontal coordinate at end of the vector that caused 
a light pen hit. IY is the vertical coordinate at end of vector which caused 

a light pen hit. The variable NAMR will contain the value of the name register 
at the time of the light pen hit. PB should be defined in the calling program 
as a six—element array. Each element will contain either the logical TRUE or 
FALSE corresponding to ON or OFF for each of the six pushbuttons. IWICH will 
be either of two values; IWICH=1 if a light pen hit has occurred, or IWICH=2 if 
a pushbutton hit has occurred. 
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LTORPB issues a .READ on light pen or pushbutton interrupt to the display 
device handler. It returns if no interrupt was posted. Otherwise*, it reads 
appropriate display registers and returns with appropriate output variables. 

The following statement illustrates use of LTORPB as a switch in a FORTRAN 
IF statement? 

IF(LTORPB (LPX,LPY ,NAME , PB,IWICH) GOTO 100 

In the above statement, if a hit has occurred (LTORPB is TRUE) LPX and LPY 
contain the X and Y coordinates of the end of the vector that was hit. Also, 
the contents of the name register is set, the status of the push buttons is 
stored in the push button array, and the variable IWICH is set to indicate 
whether the hit was due to a pushed button or to the light pen. Then, program 
execution is transferred to statement 100. 

NOTE? Each interrupt from either light pen or push buttons requires at least 
a PAIR of LTORPB's to be issued. The first LTORPB acts as an initialization, 
telling VTA that interrupts are to be accepted. This first LTORPB can only 
return a FALSE value. Interrupts that may have occurred prior to the first 
LTORPB have been ignored. The first LTORPB that occurs AFTER an interrupt(s) 
returns the light pen and push button conditions at the time of the last 
interrupt, and notifies VTA to ignore further interrupts. This brings us 
back to the initial condition. 

The general intent of the LTORPB function is wait until something happens. For 
some types of programs, the user might rather have the push buttons act as dynamic 
switches to an executing display program. In this case it is probably simpler to 
ma ke up a MACRO subroutine that reads the buttons, disregarding interrupts altogether. 

4.2 TRACK SUBROUTINE 

The TRACK subroutine is used for light pen tracking and drawing. Tracking allows 
the scope user to return an X-Y co-ordinate pair to the program. A tracking 
symbol is displayed at a location specified by the program. (The tracking symbol 
is an octagon with a point in its center.) The scope user then positions the 
tracking symbol with the light pen. A hit on any push button terminates tracking, 
and returns to the program the co-ordinates of the central point of the tracking 
symbol (as basic vectors) as well as the end point. The form of the call is as 
follows: 

CALL TRACK(IX,IY,IOPT,IARRAY[,ISIZE]) 

IX and IY are positive integer variables (0-1023 defining the initial position of 
the tracking symbol. The final position of the tracking symbol is returned in 
these same variables. IOPT is a positive integer (0-6) restricting the axes 
(see Table 4.1) along which the tracking symbol may move. An IOPT value of zero 
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means no restrictions IARRAY is zero to indicate that tracking is to occur® 
I ARRAY, for drawing, is the address of the array, empty before drawing , to 
contain the vectors describing the patch of the tracking symbol® In DOS 
V3A systems, ISIZE, the integer size of the array IARRAY, must be specified 
for the draw option® During drawing, the path appears on the screen; after 
drawing, the path subpicture file is disconnected from the main file® It 
remains as an ordinary subpicture file® Note that drawing may easily insert 
100 vectors per second into the path subpicture file® When the path file 
is full, drawing terminates® For tracking, ISIZE may not be provided. 

Examples of the use of these arguments can be found in the following sample 
program that calls TRACK® 




C THE FOLLOWING FORTRAN PROGRAM USES THE TRACKING ROUTINE 
C TO DETERMINE THE DISTANCE BETWEEN (100,400), THE INITIAL 
C POSITION OF THE TRACKING PATTERN AND ANY POINT ON A LINE 
C OF SLOPE 20, DRAWN FROM A SET POINT AT X=750 Y=250 
C 

DIMENSION MFC150),IUSERC200) 

MFC 1)-0 
I0PT=3 
1X1=100 
IY1=400 
C 

c INITIALIZE THE DISPLAY 

C CALL SET POINT TO POSITION BEAM 

C DRAW LINE FROM SET POINT 

C CALL TRACKING ROUTINE 

C 

CALL DINITCMFC 1)) 

CALL SETPTC750,250) 

CALL PL0TC1,25,500,1) 

1X2=1X1 
IY2=IY1 

CALL TRACKCIX1,IY1,I0PT,IUSER) 
c 

c GET CHANGE IN X VALUE 

C GET CHANGE IN Y VALUE 

C CALCULATE DISTANCE BETWEEN POINTS 

C 

IDELX=1X1- 1X2 
IDELY=IY1-IY2 

IDELAB=SQRT((IDELX**2)+(IDELY**2)) 

STOP 

END 


Figure 4-1. Sample TRACK Program (FORTRAN Example) 
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Table 4.1 Description of CALL TRACK Arguments 


Example 


CALL TRACK (IX,IY,IOPT,IARRAY) 


INPUT VARIABLESs 

________J 

IX 

Initial Absolute X-Position of Tracking Point (0-1023) 

IY 

Initial Absolute Y-Position of Tracking Point (0-1023) 

IOPT 

Tracking Direction Option (0-6) 


OPTION 



ALLOWABLE TRACKING 
DIRECTIONS 


ALL AXIS DIRECTIONS 


+X 

-X 


+Y 

-Y 


+X 

+Y 

-Y 

+X 

-X 

+Y 

-X 

+Y 

-Y 

+X 

-X 

-Y 



- Tracking Draw Option 


DRAW OPTION DESIRED 

Intensified Vectors Following the Lighl 
Pen Movement Are Stored in This Array 
and are Displayed. 


DRAW OPTION NOT DESIRED 


OUTPUT VARIABLES 



Final Absolute X - Position of Tracking Point (0-1023) 


Final Absolute Y - Position of Tracking Point (0-1023) 


























When TRACK is called, the X and Y input arguments are inserted into the track 
display file. The track display file is then linked to the main file by insert¬ 
ing into main file a DJMS* to a second location in the main file; into which 
has been inserted the address of the track display file. The direction option is 
then used to increment down a dispatch table which in turn sets up a second 
table so only light pen hits on certain sides of the tracking octagon are valid. 
The draw option is tested for, and if desired, the user's vector storage array 
is set up and linked to the track display file in the same manner that it was 
linked to the main file. Track then issues a .READ on Light Pen or Pushbutton 
interrupt, to the display device handler. If a light pen hit on a valid side 
of the octagon occurs, the tracking octagon is moved two raster units in the 
appropriate direction. If the draw option was specified, track adds a two raster 
unit vector to the user's vector storage array or increases the length of the last 
vector in the array if the hit was on the same side of the octagon as the previous 
hit. If a pushbutton interrupt occurs, TRACK removes all the created links and 
restores the main file to its previous form. The final X and Y coordinates of 
the tracking point are returned and control is released to the calling program. 

The macro calling sequence to track is as follows: 


.GLOBL 

TRACK 

JMS* 

TRACK 

JMP 

.+5 

. DSA 

IX 

. DSA 

IY 

.DSA 

IOPT 

.DSA 

IARRAY 


Internal Structures Created by Track: 


Main File Link to Track: 


MFTOP LENGTH 

.+1 

DJMS* .+2 
SKP 

ADDRESS 


DJMS* .+2 /Link to track display file 

DJMP* MFTOP+1 /Jump to top Of MAIN FILE 

tr CK /Address of Track display file 

Note: Track requires two temporary locations in the user's main 

file. A main file must be running when track is called. 
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Vector Array for Draw Option: 


ARTOP LENGTH 

0 

PX 

PY 

VI 

VI 


/Pile length 
/Return address 
/X set point 
/Y set point 
/Intensified vectors 


DJMP* ARTOP+1 /Display Jump to calling file 

Note: The X and Y set points must be set by the user if he desires 

to relocate his array of intensified vectors, when recalling 
it. 

(See MACRO 15 TRACK program page 4-7). 


NOTE 


Track uses name registers 120-127 
decimal. 



/ 

/ 

/ 

/ 

SAMP2 


CHK0 


CHK1 


CHK2 


CHK3 


CHK4 


CHK5 


MAINBF 

IXI 

IY1 

CNST0 

CNST1 

CNST2 

CNST3 

CNST4 


Figure 


THE FOLLOWING MACRO 15 PROGRAM USES THE TRACKING ROUTINE 
TO LOCATE OR POSITION A SET POINT ON THE DISPLAY SCREEN. 
THE POSITIONED SET POINT IS THEN USED TO DRAW A FIGURE. 


• GL OBL 

DINIT 


JMS* 

DINIT 

/INITIALIZE THE DISPLAY 

JMP 

9 + 2 


0 DSA 

MAINBF 


LAC 

(450 

/SET INITIAL POSITION OF TRACKING PATTER 

DAC 

1X1 


DAC 

IY1 


e GLOBL 

TRACK 


JMS* 

TRACK 

/CALL TO TRACKING ROUTINE 

JMP 

s +5 


a DSA 

1X1 

/X“POSITION 

e DSA 

IY1 

/Y“POSITION 

s DSA 

CNST4 

/DIRECTION OPTION 

a DSA 

CNST4 

/DRAW OPTION 

e GLOBL 

SETPT 


JMS* 

SETPT 

/CALL TO SET POINT ROUTINE 

JMP 

s +3 


e DSA 

1X1 

/X - POSITION RETURNED FROM TRACKING 

® DSA 

IY1 

/Y-POSITION RETURNED FROM TRACKING 

a GLOBL 

PLOT 


JMS* 

PLOT 

/CALL TO PLOT ROUTINE 

JMP 

®+5 


o DSA 

CNST0 

/ARG e TO PLOT A LINE 

a DSA 

CNST1 

/DELTA X 

® DSA 

CNST1 

/DELTA Y 

® DSA 

CNST0 

/INTENSIFY THE LINE 

JMS* 

PLOT 


JMP 

© + 5 


s DSA 

CNST0 


• DSA 

CNST1 


o DSA 

CNST2 


e DSA 

CNST0 


JMS* 

PLOT 


JMP 

a+5 


. DSA 

CNST0 


a DSA 

CNST3 


@ DSA 

CNST4 


o DSA 

CNST0 


HLT 

s BLOCK 

50 

/DISPLAY MAIN FILE BUFFER 


0 

0 

1 

25 

-25 

“50 

0 

• END 


if.--2. Sample TRACK Program (MACRO 15 Example) 
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CHAPTER 5 


RELOCATING ROUTINES 

The subroutines DYSET and DYLINK are used to allow display main or subpicture 
files, which refer to each other (via COPY or PLOT (0....)), to be output and 
input to some external medium relocatably* This includes arrays of 5/7 ASCII 
that are referred to via TEXT or PLOT(3....). Prior to outputting, interdepen¬ 
dent display files and their user-assigned ASCII names are listed as arguments 
in a call to DYSET, which converts each subpicture call to the ASCII name of the 
subpicture being called e After input, and prior to displaying, a corresponding 
call is made to DYLINK, which uses the listed ASCII names to reinstate the 
appropriate subpicture calls or text references. A display file cannot be displayed 
after having been processed by DYSET? DYLINK must be used to return it to display- 
able form. 

WARNING’ DYSET and DYLINK do not function properly if any of the referenced dis¬ 
play files are above 24K. 


5.1 DYSET SUBROUTINE 


The DYSET subroutine converts subpicture calls or text references to a symbolic 
form independent of core memory location, using specified ASCII strings. The 
forms are, 


CALL DYSET (PNAME1,ASCII1PNAMEN,ASCIIN) 
or 

CALL DYSET (PNAME1, ASCII1, . . . ,PNAMEK, ASCIIK, 0, PNAMEL , ASCIIL, . . . 

,PNAMEN,AS Cl IN ) 

The variable PNAMEs are the first locations of the interdependent display files, 
both calling and called. If a 0 argument appears in the argument string, subse¬ 
quent PNAMEs refer to arrays of 5/7 ASCII text. (These files will not be 
searched for memory references.) The ASCIIs are the names of real arrays contain¬ 
ing nine characters of 5/7 IOPS ASCII, which may be used for filenames on output. 

Subroutine DYSET searches each listed display file (PNAME) for a DJMS or CHARS 
instruction. When it finds one, it appends the ASCII name of the file referenced 
to the file being searched, if that name is not already there. The operand of 
the DJMS is made a relative pointer to the ASCII name of the referenced file. 

The first location of the file being searched is increased by four each time an 
ASCII name is appended to the file. 
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Certain restrictions must be noted; space provided for a display file must 
include four locations for each subpicture or text array that is called. 

Display commands must not be added to a display file nor can a file be 
displayed once it has been processed by DYSET, or until after it has been 
processed by DYLINK. (Thus DYSET must be called after DCLOSE for a main 
display file.) Also, it is the user's responsibility to list all relevant 
display files when calling DYSET. The subroutine does not check the list 
for completeness in order to allow multiple calls to it. Once a zero appears 
in the argument string, all subsequent PNAMES must refer to arrays of 5/7 
ASCII text. 

5 * 2 DYLINK SUBROUTINE 

The DYLINK subroutine converts file names to appropriate DJMS or CHARS instruc¬ 
tion references to the corresponding files. The forms are: 

CALL DYLINK(PNAME1,ASCII1,...,PNAMEN,ASCIIN) 
or 

CALL DYLINK(PNAME1,ASCII1,...,PNAMEK,ASCIIK,0,PNAMEL, 

ASCIIL,...,PNAMEN,ASCIIN) 

where the input variables are the same as for DYSET. DYLINK searches each 
listed display file for a DJMS or CHARS instruction. When it finds one, it 
searches the argument list for a pointer to an ASCII string equal to the one 
pointed at by the operand of the DJMS or CHARS instruction. This operand is 
replaced by the address of the corresponding file, obtained from the argument 

list. The first location of each display file that is searched is reduced to 
the actual number of display commands in the file (excluding the ASCII blocks). 

It is the user's responsibility to list all relevant display files when calling 
DYLINK. The subroutine does not check the argument list for completeness, to 
allow multiple calls. Once a zero appears in the argument string, all subsequent 
PNAMEs must refer to arrays of 5/7 ASCII text. See Figure 5-1 for DYSET/DYLINK 
Program, 
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ARRAY INITALIZATION 

DIMENSION NWPIC0C40), NWPIC1C20), NWPIC2(20) 

DIMENSION RTXTAC2), RTXTB(2) 

DIMENSION XMA1NC40), IP1CAC20), IPICBC20) 

DIMENSION TEXTAC2), IEXTBC2) 

DIMENSION TITL1(2), TITL2C2), TITL3C2), TITL4C2), TITL5C2) 
DATA TITLl(l), T1TL1(2)/5HJPIC0, 4H BIN/, 

2TITL2C1), TITL2(2)/5HJPICA, 4H BIN/, 

3TITL3CI), TITL3(2)/5HJPICB, 4H BIN/, 

4TITL4C1), TITL4(2)/5HCHRSA, 4H BIN/, 

5TITL5C1), TITL5(2)/5HCHRSB, 4H BIN/ 

DATA TEXTACi), TEXTAC25/5HI AM ? 4HB0XA/, 
iTEXTBC1), TEXTBC25/5HI AM , 4HB0XB/ 

INITIALIZE DISPLAY FILES e 

IMAIN(I)=0 
IPICAC1)=0 
IPICBC1)=0 

BUILD BOXB (IPICB) 

CALL TEXT (T£XTB(i),9, IPICB(D) 

CALL LINE (100,0,15 
CALL LINE (0,100,1) 

CALL LINE (-100,0,1) 

CALL LINE (0,-100,1) 

BUILD BOXA (IPICA) 

CALL LINE (300,0,1 ,IPICA(D) 

CALL LINE (0,300,1) 

CALL LINE (-300,0,15 
CALL LINE (0,-300,1) 

CALL LINE (30,30,0) 

CALL COPY (0,IPICBC!)) 

BUILD MAIN CIMAIN) 

CALL DINIT (IMAIN(l)) 

CALL PLOT (2,19,0,4,0) 

CALL SETPT (20,20) 

CALL PLOT C3,TEXTAC1) ,5) 

CALL PLOT (0,1,IPICAC1)) 

CALL SETPT (534,20) 

CALL PLOT (3,TEXTAC1),9) 

CALL PLOT (0,0,IPICAC1)) 


DCLOSE, CALL DYSET, AND OUTPUT TO DECTAPE (DAT 5) 


CALL DCLOSE 

CALL DYSET (IMAIN(1),TITL1,IPICA(1),TITL2,IPICBC1),TITL3,0, 
1TEXTAC1),TITL4,TEXTB(1),TITL5) 

CALL ENTER (5,TITL1) 

J= IMAINCD+l 

WRITE (5) (IMAIN(I), 1=1,J) 

CALL CLOSE (5,TITL!) 


Figure 5-1. DYSET/DYLINK Program Example 
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CALL ENTER (5.TITL2) 

J= I PI CAC1)+1 

WRITE (5) (IPICACI), 1=1,J) 
CALL CLOSE (5,TITL2) 


CALL ENTER (5,TITL3) 
J=IPICB(I)+l 

WRITE (5) (IPICB(I), 1=1,J) 
CALL CLOSE C5,TITL3) 

C 

C 

CALL ENTER (5,TITL4> 

WRITE (5) (TEXTA) 

CALL CLOSE (5,TITL4) 


CALL ENTER (5,TITL5) 

WRITE (5) CTEXTB) 

CALL CLOSE (5,TITL5) 

PAUSE 222 

INPUT FROM DECTAPE, CALL DYLINK AND DINIT 

CALL SEEK C5,TITLi) 

READ (5) J, CNWPIC0CI+1), 1=1,J) 

NWPIC0(I)=J 

CALL CLOSE <5,TITLI) 


CALL SEEK (5,TITL2) 

READ (5) J, CNWPIC1(1+1), 1=1,J) 

NWPICl(1) = J 

CALL CLOSE C5,TITL2) 


CALL SEEK C5,TITL3) 

READ (55 J, (NWPIC2CI+15, 1=1,J> 

NWPI C2 ( 1) = J 

CALL CLOSE C5,TITL3) 


C 

C 


C 

C 


CALL SEEK <5,TITL4) 
READ (5) RTXTA 
CALL CLOSE <5,TITL4) 


CALL SEEK (5,TITL55 
READ (5) RTXTB 
CALL CLOSE C5,TITL5) 


CALL DYLINK ( NWPI C0 < 1) , TI TL1, NWPI Cl (1) , TI TL2, NWPI C2 ( 1 ) TITl^ 0 
1RTXTA(1),TITL4,RTXTBC1) , TITL5) $ 90: 

CALL DINIT (NWPIC0C1)) 

STOP 

END 
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CHAPTER 6 


SYSTEM I/O DEVICE HANDLER 


The VT15 Graphic Display Device Handler provides an interface between the user 
and the hardware. In general, it conforms to the conventions of the Keyboard 
Monitor System, as described in DEC manual Monitors, ADVANCED Software System . 
Input or output functions are initiated by standard user program commands and 
all display interrupt management is done automatically by the handler. The 
primary goals of the device handler are to relieve the user from writing his own 
device handling subprograms and to centralize all direct communication between 
the PDP-15 and the display processor. To start up a display, the user generates 
a display file consisting of display commands then calls the device handler to 
start it running. To interact with it, the device handler is used to read 
display controller registers and to dispatch on appropriate interrupts. 

6.1 .INIT (INITIALIZE) MACRO 

The macro .INIT causes the display to be initialized and must be given before 
any other I/O macro to the display is issued. The display is initialized 
according to four words of standard settings contained in the handler. The 
user may substitute his own settings for any of these. 

The Device Handler is connected to the Monitor Interrupt system (PIC or API) 
in the same manner as other system device handlers. 

The form is; 


. INIT A, F, R 

A = Device Assignment Table (.DAT) slot number 
F = initialization flag 

0 use standard display initialization 
1 user s initialization is pointed to by R 

R - optional pointer to user's initialization settings 

If F = 1, R points to a word containing initial settings. 

If F = 0 and R = 1, clearing the READ BUSY switch is the only action 
taken by the handler. 

The expansion is; 


FOC CAL + F (7-8) + A(9-17) 

LOC+1 1 v ' 

LOC+2 R 


6-1 



The normal settings are:. 

a* Set display status to 

1. DISABLE edge flag interrupts 

2. ENABLE light pen interrupts 

3. ENABLE pushbutton interrupts 

4 • DISABLE external stop interrupts 

5. ENABLE full 12 Bit X and Y beam position registers 

6. ENABLE internal stop interrupts 

b. Connect handler to PIC or API 

c. Clear READ BUSY switch 


Initialization IOT 


SIC (703024) Set Initial Conditions - SIC sets up a number of status registers 
in the display. The instruction enables five display flags onto the Interrupt 
Line. The IOT is issued with settings loaded in the AC in the following format; 



0 Sets the Stop Flag Interrupt Enable Flop 

1 Sets the LP Flag Interrupt Enable Flop 

2 Sets Edge Flag Interrupt Enable Flop 

3 Sets PB Hit Interrupt Enable Flop 

4 Sets External Stop Interrupt Enable Flop 

5 Clears Stop Flag 

6 Clears LP Flag 

7 Clears Edge Flag 

8 Clears PB Flag 

9 Clears External Stop Flag 

10 Allow a Change in Virtual Paper Size 

11 New Virtual Paper Size 

12 New Virtual Paper Size 


Bits 11 & 12 (New paper Size) 
00 = 9.5 inch (10 bits) 
1024 raster units 

01 = 19 inch 

2048 raster units 

10 = 28.4 inch 

3072 raster units 

11 = 38 inch (12 bits) 

4096 raster units 
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6.2 » READ MACRO 


The .READ macro is used for input to the user program from the hardware registers 
of the display controller. The user may select standard groups of registers to 
be read, in response to each possible display interrupt flag, or he may indicate 
his own group of flags and registers. This is done with an optional descriptive 
word following the .READ macro, the first five bits of that word indicate which 
interrupts are of interest and the next nine indicate the registers to read if 
any of those interrupts are set. 

The form is, 

.READ A, M, L, W 

NSTD 


where NSTD — optional word describing non-standard groups. 



The variables A = .DAT slot number, M = type of read; 

$ = READ,PB,XP,YP,S1,S2 Read now, no interrupts 

1 = READ,PB,XP,YP,DPC,S1,S2,NR If stop flag interupt flag is set 

2 = READ,PB,XP,YP,DPC,S1,S2,NR If pushbutton interrupt flag is set 

3 = READ,PB,XP,YP,DPC,S1,S2,NR If light pen interrupt flag is set 

4 = READ,PB,XP,YP,DPC,S1,S2,NR If edge flag interrupt flag is set 

5 = READ,PB,XP,YP,DPC,SI,S2,NR If external stop interrupt flag is set 

7 = NSTD specifies registers and interrupt flags as follows: 

Bit 0 on service internal stop interrupt 
Bit 1 on service pushbutton interrupt 
Bit 2 on service light pen interrupt 
Bit 3 on service edge flag interrupt 
Bit 4 on service external stop interrupt 
Bit 5 on read pushbuttons (PB) 

Bit 6 on READ X position register (XP) 

Bit 7 on READ Y position register (YP) 

Bit 8 on READ DISPLAY program counter (DPC) 

Bit 9 on READ STATUS one (Si) 

Bit 10 on READ STATUS TWO (S2) 

Bit 11 on READ NAME REGISTER (NR) 

Bit 12 on READ SLAVE GROUP 1 (SGI) 

Bit 13 on READ SLAVE GROUP 2 (SG2) 


L return buffer address, C(l) = descriptive word showing what this interrupt 
was and which registers were read in the order listed above. C(L+1) = contents 
of first register actually read, C(L+2) = contents of second register read, etc. 
W = 1 (W must equal 1). 
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The expansion is; 


LOC 

CAL + 

M(6-8) + A(9-17) 

LOC+1 

10 


LOC+2 

L 


LOC+3 

-W 

/DECIMAL 

LOC+4 

NSTD 



.READ determines interrupts to be serviced and turns on read busy flag. 


6.3 .WRITE MACRO 


The .WRITE macro is used to transmit information from the user program to the 
display controller, once a display file has been generated. Its location is 
passed on to the display controller by a call to .WRITE, and the display 
starts up. 


.WRITE is also used to stop the display, by issuing an external stop, and to 
start the display if it has been stopped. A .WRITE to the display is done 
immediately and requires no waiting. 

The form is, 

.WRITE A, M, L, W 

A = .DAT slot number 
M = type of write, 

where 0 = restart display (L not required) 

1 = resume display after internal stop 

Note: The display is automatically resumed after 

LP or EDGE violation interrupt. 

2 = stop display (external stop) 

4 = start display pointed to by L 

L = display file starting address 
W = not used 


The expansion is: 


LOC CAL + M(6-8) + A(9-17) 

LOC+1 11 

LOC+2 L 

.DEC 

LOC+3• -W /DECIMAL 


6.4 .WAIT MACRO 


The .WAIT macro is used to synchronize the user program with the interrupt 
activity of the display. .WAIT is only defined with respect to .READ. If a 
.WAIT is given, the user program waits until the previous .READ has completed, 
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that is, the interrupt has occurred. If the previous .READ specified more than 
one kind of interrupt flag, the descriptive word(s) in the input buffer can be 
interrogated to determine what flags were set. .WAIT does not initiate any dis¬ 
play activity. 

The form is, 

.WAIT A 

The variable A = .DAT slot number. 

The expansion is, 

LOC CAL + A(9-17) 

LOC+1 12 

.WAIT allows a previous .READ to be completed and turns off input busy flag. 

6.5 .WAITR MACRO 


The .WAITR macro allows the user program to proceed in line if the previous 
.READ is complete. If the previous .READ is not complete, control is given 
to the location in the user program specified by the .WAITR call. This allows 
the user to branch to some other part of his program while waiting for the 
.READ to finish. The user must continue to check for completion by periodically 
issuing .WAITRs or by issuing a .WAIT. 

The form is, 

.WAITR A, ADDR 

The variables A = .DAT slot number, and ADDR = location in the user program 
to branch to if input is not completed. 

The expansion is, 


LOG CAL+1000 + A(9—17) 

LOC+1 12 
LOC+2 ADDR 


6.6 .CLOSE MACRO 


The .CLOSE macro is used to terminate the current display. External STOP 
and CLEAR flags IOTs are issued. It is up to the user to save the display file 
if desired. 
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The form is .CLOSE A where A = .DAT slot number. 


The expansion is, 


LOC CAL + A(9-17) 

LOC+1 6 


6.7 .FSTAT MACRO 


The .FSTAT macro checks the status of a file specified by the file entry block 
On return, the AC will contain zero and bits 0-2 of LOC+2 will also be zero, 
stating that the device was non-file oriented. 

The form is, 

.FSTAT A, D 

where the variables A = .DAT slot number, and D = starting address of three 
word block of storage in user area containing the file name and extension of 
the file name whose presence on the device associated with .DAT slot A is to 
be examined. 

The expansion is, 

LOC CAL+3000 + A(9-17) 

LOC+1 2 

LOC+2 D 

6.8 IGNORED FUNCTIONS 

The following system I/O macros are ignored by the VT15 display device handler 


1. .DLETE 

2. .RENAM 

3. .ENTER 

4. .CLEAR 

5. .MTAPE 

6. .SEEK 

7. .TRAN 
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CHAPTER 7 


LK35 KEYBOARD HANDLER 


The LK35 Keyboard device handler (LKA) provides an interface between the user and 
the hardware. In general, the handler, LKA, conforms to the conventions of the 
DOS and ADSS monitor software systems. Since the LK35 is a send-only device, 
the LKA handler provides only input functions. Input functions are initiated by 
standard user program commands; all interrupt management is done automatically 
by LKA. 

The LKA handler relieves the user of the task of writing his own device handling 
subprograms and centralizes all direct communications between the PDP—15 computer 
and the LK35 Keyboard. This handler only inputs IOPS ASCII or IMAGE ASCII 
data into a user-designated buffer; it is up to the user to develop the display 
of any input text on the VT04 display CRT or output it to any other device. 

The LK35 Keyboard is connected to either an LT15 or LT19D controller. 

The LKA handler is a resident program, it resides with the Keyboard Monitor and 
other required device handlers. It does not require EAE and it operates with 
both PI and API. 

7.1 .INIT (Initialize) MACRO 


This macro initializes the LK35 Keyboard; it must be called before any other 
I/O macro is issued to this device. 

When .INIT is issued it initializes the LKA handler, which returns the size of 
the current line buffer (34 10 standard) to the macro. 

If .INIT is issued during a .READ, it will abort this operation. 

The form of this macro is: 


.INIT a,f,r 


where s 

a = .DAT slot number 
f = ignored by LKA 
r = control p address 
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The expansion of this macro is 


LOC CAL+fy_gta^_^y 

LOC+1 1 
LOC+2 r 

LOC+3 n (standard buffer size 34 ^q) 

7.2 o READ MACRO 


This macro performs the operations required to input data from the LK35 Keyboard 
and transfer it to the memory input line buffer. In performing this function, 
the .READ macro; 


a) allows any previous input operation to terminate, 

b) sets the "input underway" indicator, 

c) accepts and performs the operations indicated by; 

1) RUBOUT - delete previously entered (typed) character, 

2) CTRL U (fU) - delete all entries made prior to fU. 

d) recognizes IOPS ASCII string terminators ALT MODE and RETURN 
(carriage return). 

e) is terminated, during IMAGE ASCII read operations when the 
given line buffer word count (see form) is reached. 

The form of the .READ macro is: 


.READ a,M,L,W 


where: 

a = .DAT slot number 

M = Data Mode 

2 = IOPS ASCII 

3 = IMAGE ASCII 

L = Line buffer address 

W = Line buffer word count (including 2-word header pair) 

The expansions of this macro are: 


LOC 

LOC+1 

LOC+2 

LOC+3 


CAL+ M 6_8+ag_i7 

L 

-W 
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7 . 3 a WAIT MACRO 


The .WAIT macro is used to detect the availability of the user’s line buffer for 
data transfer operations. If the buffer is unavailable when tested, control 
remains with the macro; if the buffer is available, control is returned to the 
user. 

The form of this macro is: 

.WAIT a 

where a represents a .DAT slot number 

The expansion of the macro is: 

LOC CAL+a q 

LOC+1 12 y X/ 


7 . 4 .WAITR Macro 

This macro enables the user to test the status of a previously initiated .READ 
operation. If the .READ operation is complete the user's program is permitted 
to proceed in line; if the .READ operation is not complete control is given to 
a user-specified location expressed in the .WAITR macro call. The latter fea¬ 
ture permits the user to branch to some other part of his program while wait¬ 
ing for the completion of the .READ operation. 

The form of this macro is: 

.WAITR a,ADDR 


where: 


a = .DAT slot number 

ADDR = location to branch to if .READ operation is incomplete. 


The expansion of this macro is: 


LOC CAL+1000+A q __ 
LOC+1 12 y 17 
LOC+2 ADDR 
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7.5 .CLOSE MACRO 


The LKA handler regards the .CLOSE macro as being the same as the .WAIT macro 
(see 7.3). 

The form of this macro is: 

.CLOSE a 

where a = .DAT slot number. 

The expansion of this macro is: 

LOC CAL+a q ._ 

LOC+1 6 

7.6 .FSTAT Macro 


If used, this macro will return a zero to the AC since the LK35 is a non- 
directoried device. The form of this macro is: 

.FSTAT a,D 

where: 

a = .DAT slot number 

D = ignored by LKA. 

The expansion of .FSTAT is: 

LOC CAL+3000+a q ,_ 

LOC+1 2 ±/ 

LOC+2 D 

7.7 IGNORED FUNCTION 

The .SEEK macro is ignored by the LKA handler. 


7-4 



7.8 ILLEGAL FUNCTIONS 


The following macros are illegal with regard to the LKA handler. 


.WRITE 
.DLETE 
.RENAM 
.ENTER 
.CLEAR 
. MTAPE 
.TRAN 


7.9 LEGAL CONTROL CHARACTERS 


The following keyboard control entries are recognized by LKA; 


% 



ENTRY 

OPERATION 

1) 

CTRL 

C 

Cl c) 

Performs on .EXIT to the Monitor. 

2) 

CTRL 

P 

(IP) 

Transfers control to the address 
given in the .INIT cal. 

3) 

CTRL 

D 

(ID) 

Gives an End-of-Medium header word 


pair to the user. 
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CHAPTER 8 


VW01 Writing Tablet Handler 


The VWOl Sonic Digitizer Writing Tablet converts graphical information, in the 
form of X- and Y-coordinates, to digital data that can be input to a digital 
computer. The major components of the VWOl, are the writing tablet, spark pen, 
component box, and computer interface logic. 

The user places a sheet of paper on the writing tablet and draws sketches, 
schematics, and hand-written symbols or characters using the special ball-point 
spark pen. The sound of the spark emitted by the pen is picked up by microphones 
located along the X- and Y-axes of the writing tablet. The time lapse, from 
spark emission until the sound is picked up by each bank of microphones, is ac¬ 
curately measured to provide a digital record of the X- and Y-coordinates of 
the spark pen location on the paper. 

The digitized graphic data is input to a digital computer via the VWA handler 
for immediate or delayed processing. 

The VWOl operates in either of two modes: Single Point or Data Input. 

In the Single Point mode of operation, a single spark is generated each time the 
spark pen is pressed against the writing surface. The spark is initiated by the 
closure of a microswitch within the spark pen. The Single Point mode is used 
if the operator desires to plot points. For example, to plot points at four 
different locations, he positions the pen point at each location. Then, by 
pressing and releasing the pen at each position, the corresponding X-Y coordi¬ 
nate pairs are sensed and digitized. 

In the Data Input mode, a continuous series of sparks are generated at a constant 
rate, under control of clock pulses. The X-Y coordinate pairs are continuously 
generated and input to the computer. This mode allows the user to draw continu¬ 
ous lines, circles, curves, etc., that can be displayed on the CRT. 

At the time a spark is generated, X- and Y- clock pulses are initiated which 
increment X- and Y- hardware registers until the sound of the spark is received 
by the X- and Y-microphones. As soon as a microphone detects the sound, the 
associated X- or Y-clock pulses are inhibited, and the register stops increment¬ 
ing. The binary numbers contained in the X- and Y-registers will then be 
directly proportional to the X- and Y- coordinates of the position at which the 
spark was emitted. 
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The VWA device handler for the VW01 Sonic Digitizer Writing Tablet provides an 
interface between the user and the hardware. In general, it conforms to the 
conventions of the Keyboard Monitor System in either the ADSS or DOS software 
in DEC manual ADVANCED Monitor Software system. Initialize and input functions 
are initiated by standard user program commands (system macros). The device 
handler relieves the user from writing his own device handling subprograms 

The Writing Tablet handler makes no tests on incoming X- and Y-coordinates. All 
coordinates are handled directly back to the user. This means that if the pen 
stays on the same spot (Data Input mode) or is pushed on at the same spot more 
than once (Single Point mode) the same X- and Y-coordinates are handled to the 
user. Repetitive X- and Y-coordinates should not be sent directly to the VT- 
handler since they could cause a hole to be burned on the display-screen. For 
this reason it is the user’s responsibility to ignore X- and Y-coordinates 
which are generated on one and the same spot. The number of times the same co¬ 
ordinates could be accepted also depends on the intensity. 

8.1 .INIT (INITIALIZE) MACRO 

The macro .INIT causes the Writing Tablet to be initialized and must be given 
prior to any other I/O command referencing this device. 

The .INIT macro clears one software and two hardware flags. These flags are: 


1) 

Handler Busy flag 

/Software 

2) 

Data Ready flag 

/Hardware 

3) 

Pen Data flag 

/Hardware 

form 

is: 



.INIT A,F,R,n 



where: 

A = Device Assignment Table (.DAT) slot number 

F = Not used 

R = Not used 

n = Not used 

The expansion is; 

LOC CAL+F(7-2)+A(9-17) 

LOC+1 1 /Function code for .INIT 

LOC+2 R 
LOC+3 n 
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8 » 2 .READ MACRO 


The .READ macro is used for input point data to the user from the Writing 
Tablet. The input always consists of one status word and two words con¬ 
taining the X- and Y-point coordinates. 

The status word has the following format: 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 

Input .DAT flag Writing Tablet Identifier Bits 


i : 


means: 





Bit 

0 = 0 
= 1 

Input 

Input 

from 

from 

"DATA READY" 
"PEN DATA" 


Bit 

14=1 

Input 

from 

Writing 

Tablet 

1 

Bit 

15=1 

Input 

from 

Writing 

Tablet 

2 


16 = 1 

Input 

from 

Writing 

Tablet 

3 


17=1 

Input 

from 

Writing 

Tablet 

4 


The form is: 

-READ A,M,L,W 


where: 


A = Device Assignment Table (.DAT) Slot Number 
M = Data Mode: 

0 = Single Point 

1 = Single Point multiplexed 

2 = Data Input (not scan!) 

3 = Data Input multiplexed (scan!) 

L = Line buffer address 

Points to a three word data buffer 
W = Writing tablet to be selected (1-4) 


The expansion is: 


LOC CAL+M(6-8)+A(9-17) 
LOC+1 10 
LOC+2 L 
LOC+3 W 


/Function code for .READ 
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8.3 .WAIT MACRO 


The .WAIT macro is used only with respect to the .READ macro. If a .WAIT is 
given the user program waits until the .READ has completed, that is, when the 
line buffer is filled and is again available for the user program. If the line 
buffer is available, control is returned to the user immediately after the .WAIT 
macro expansion (LOC+2). If the input of data has not yet been completed, 
control is returned to the .WAIT macro. 

The form is: 

.WAIT A 


where: A = Device Assignment Table (.DAT) slot number 

The expansion is: 

LOC CAL+A (9-17) 

LOC+1 12 /Function Code for .WAIT 


8.4 vWAITR MACRO 


The .WAITR macro is also used only with respect to the .READ. If the previous 
.READ is done, control is returned to the user immediately after the .WAIT in 
order to proceed in line. If the input of data has not yet been completed, 
however, control is given to a location in the user program specified in the 
.WAITR call. 

The form is: 

.WAITR A,ADDR 


where: A = Device Assignment Table (.DAT) slot number 

ADDR = Location in the user program to which control must 
be transferred if input is not completed. 


The expansion is; 

LOC CAL+lOOOg+A(9-17) 

LOC+1 12 /Function code for .WAITR 

LOC+2 ADDR 
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8.5 .FSTAT MACRO 


The .FSTAT macro checks the status of a file specified by the file entry block. 
On return the AC will contain zero and bits 0-2 of LOC+2 will also be zero, 
stating that the device was non-directoried„ 

The form is: 


•FSTAT A,D 


where: 

A = Device Assignment Table (.DAT) slot number 

D — Address of a three word block of storage (directory entry 
block) in user area containing the file name and the ex¬ 
tension of the file whose presence is to be examined. 

The expansion is: 


LOC CAL+3000 +A(9-17) 
LOC+1 2 a 

LOC+2 D 


/Function code for .FSTAT 


8.6 .CLOSE MACRO 


Once input has been initiated (.INIT and .READ) it must be terminated by the 
.CLOSE macro. The hardware flags (Data Ready and Pen Data) are cleared and the 
Writing Tablet(s) is disabled in order to prevent illegal interrupts. 


The form is: 

.CLOSE A 


where: A = Device Assignment Table (.DAT) 

The expansion is: 


slot number 


LOC CAL+A(9-17) 
LOC+1 6 


/Function code for .CLOSE 
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8.7 


IGNORED FUNCTIONS 


The following macros are ignored by the VWA device handler: 


1) 

.SEEK 

2) 

.ENTER 

3) 

.CLEAR 

4) 

.MTAPE 

5) 

.WRITE 

6) 

.TRAN 

7) 

.DLETE 

8) 

.RENAM 
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CHAPTER 9 


TEXT DISPLAY/EDIT FUNCTIONS 

The VT15 GRAPHICS software provides the user with a complete text editing program, 
EDITVT, and a soft copy display feature, CONTROL X. 

The EDITVT program has the same command and editing structure as the standard 
Editor (i.e., EDIT, refer to DEC-15-YWZB-DN ) except that the majority of the 
text presentation takes place on the VT04 display CRT. The Control X (CTRL X) 
feature enables the user to, essentially, replace the console printer with the 
display CRT when desired. 

9.1 EDITVT 

Systems which have a VT15 Graphics Display unit permit the user to employ program 
EDITVT for editing purposes. Program EDITVT enables the user to perform soft 
copy editing of files using the VT15 display as a file data display device. 

Data is displayed in sets of either 56, 72-character lines or 28, 72-character 
lines. The EDITVT commands and the editing functions performed are essentially 
the same as those of the standard Editor program (EDIT, refer to DEC-15-YWZB-DN6). 

9.1.1 Setup Commands 

The following commands must be issued to the monitor prior to loading EDITVT: 

a) $ VT ON Enables the VT display unit,, 

b) $ HALF ON/OFF This command is optional? it enables the 

user to set up a half-screen display 
(i»e B , 28 72-character lines) condition 
in which only half the screen is used for 
display. 

c ) $ (control X) Turn on VT display unit. |i 

The program EDITVT is loaded into core by the command "EDITVT" given to the 
Monitor. Once loaded, the program announces itself by outputting its name and 
version number on the console printer. The user must then input the command 

"TV ON" to initiate the VT15 display operations. VT15 display operations may be 
stopped at any time by the command "TV OFF". 

9.1.2 Controls 

The VT-15 Display console contains a horizontal strip of six square push-to- 
light push buttons which are used in display operations. These push buttons 
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are unmarked since their function is determined by software and may vary 
according to the particular program (system or user) which is in control of the 
system. 


In EDIT operations, only the two rightmost push buttons are needed; these 
switches are referred to as numbers 5 and 6, based on the following numbering 
s cheme: 



9.1.3 Display Modes 


The VT-15 Display operates in two display modes: 


a) SCROLL Mode - When the number 5 push button is in the OFF (unlit) 

position, the display is in the SCROLL mode. In 
this mode, when the display screen is full, the 
next line of data to be displayed causes the dis¬ 
played material to "roll" upwards, line-by-line, 
with new data displayed at the bottom of the 
screen. 

k) PAGE Mode - When the number 5 push button is in the ON (lit) 

position, the display is in the PAGE mode. In thxs 
mode, when the screen is full, the next entered 
material for display causes the complete, full¬ 
screen display (i.e., PAGE) to be erased; the new 
material is then displayed starting at the top line 
of the screen. When a large file is to be displayed 
in the PAGE mode, the number 6 control push button is 
used to advance the display through the file page 
(screen) by page (screen). Each time this push button 
is actuated, the screen is cleared and the next set 
(page) of data available is displayed. 

9.2 CONTROL X FEATURE 


The Control X feature gives the user the ability to change from hard to soft 
copy at any time during Monitor operation. When Soft copy is desired the 
user types VT ON when under Monitor Control and then a Control X. The VT ON 
command sets up the necessary linkage in the teletype handler and also reserves 
a segment of core to be used for the Display Buffer. The Control X command 
may be typed during Monitor Control or during System Program Control; it 
switches output from the device presently being used to the alternate device. 
(Teletype to display or display to teletype.) When the display is being used, 
teletype input is echoed on both the teletype and on the display while teletype 
output appears only on the display. 
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9.2.1. SCROLL Mode 


When text is being output to the display and the display screen is filled (56) 
lines, the next incoming line appears on the bottom of the screen and the oldest 
or top line on the screen disappears. It appears as if the text is rotating 
from screen bottom to screen top. The display screen may be cleared at any 
time and new text begins at screen top by changing the position of push button 
number 6; and then typing a carriage return. 

9.2.2 PAGE Mode 

The display may be put in page mode operation. That means that when the dis¬ 
play has 56 lines being presented it stops output to it so the user can inspect 
the text and it then waits for the user to advance to the next page. This fea¬ 
ture is useful for doing a PIP transfer of a large file to the displayi the 
file can be read on the display a page at a time. It is also useful for looking 
at Macro Assemblers and FORTRAN compilations on the display. Page Mode opera¬ 
tion is entered by setting push button number 5 to the ON position; for normal 
operation (text rotation across screen) push button number 5 should be in the 
OFF position. When in page mode, a page is advanced by changing the position 
of push button number 6. 

.9*2.3 VT QN/OFF Monitor Commands 

The VT ON command sets up the interface between the VT15 Display System and the 
Teletype Handler Section of the Resident Monitor. The Display Interface Code 
is moved to a position directly above the Resident Monitor and essentially be¬ 
comes a part of the resident monitor. The VT ON command also reserves a segment 
of core for use as the Display Buffer. Once the VT ON command has been issued 
the user has the ability to switch his output device from Teletype to display 
and from display to teletype. The output device switching is accomplished by 
typing a tX (Control X); and may be done when under monitor control or user 
program control. 

The feature gives the user the ability to work from an extremely fast, soft 
copy output device; and easily switch to hard copy when it is desired. When tX 
i s typed, an Up-Arrow (1) is echoed on the device selected for output. The 
VT OFF command releases the reserved core segment and it frees the area of core 
directly above the Resident Monitor where the Display Interface Code was moved. 
The VT ON command remains in effect until VT OFF is issued or the Monitor System 
is bootstrapped. If the VT15 Display System is desired as the primary output 
device, VT ON ma y be set at System Generation time. The VT OFF command can over¬ 
ride the System Generation setting, allowing selection of hard copy output. 
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9.2.4 HALF ON/OFF Monitor Command 


The HALF ON/OFF command can be used in tX operations. 

9.2.5 Differences Between CTRL X in V5A (i,e ef ADSS) and in DOS 

Control X will work slightly differently under D0S15 than under the Advanced 
Monitor System (ADSS). The D0S15 Monitor also includes some additional features 
associated with +X. 

The System Generator under ADSS does not ask questions concerning VT ON/OFF 
and half buffer ON/OFF settings. Under D0S15 the VT can be set to the ON posi¬ 
tion at system generation time and then it will not be necessary for the user 
to type VT ON; the same applies to HALF buffer ON. Under D0S15 the loading of 
a system CUSP does not cause the display to be cleared thus requiring another 
fX to be typed. Under D0S15 the display will continue its text presentation 
not only when system CUSPs are loaded but also when the Monitor is refreshed. 
Control X under ADSS (V5A) is NOT supported but is available to the user. 
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APPENDIX A 


MNEMONICS COMMONLY USED IN GRAPHICS SUBPROGRAM CALLS 


The following mnemonics are commonly used in describing subroutine call state¬ 
ments throughout this manual. 


Mnemonic 


1. DELTAX 


2. DELTAY 


3 „ INT 


4. PNAME 


5. STR 


6 . 


Definition 


An integer number or variable which represents in 

raster units the amount the CRT beam is to be displaced 

from its current position in a horizontal direction. 

This quantity is signed to indicate the direction of 

displacement (i.e., + = move beam right 

- = move beam left). 

Same as DELTAX except that the indicated displacement 

is made on a vertical direction and the directions 

indicated by the sign are: + = move beam up 

- = move beam down. 

This variable is restricted to the Integer values 1 

and 0 to indicate if the CRT beam movement is to be 

visible, (INT = 1) to draw a line, or 
invisible (INT = 0). 

The subpicture display files generated by the graphic 
subpicture calls are stored in dimensioned integer 
arrays specified by the user. The integer variable 
PNAME specifies the first element of the array into 
which commands generated by a particular call are to 
be stored. PNAME is always represented as a subscripted 
variable; it will contain the length of the file and is 
the variable by which the file is referenced in later 
manipulations. 

NOTE: The variable PNAME may be dropped from the 

statement argument lists; if dropped, the 
last given value for PNAME will be assumed. 

Identifies the dimensioned real array which contains 
the string of characters to be displayed in IOPS ASCII 
(Hollerith) form (five 7-bit characters per word). 

An integer number which identifies a hardware feature(s) 
to be specified in the call (e.g., 1 = scale, 2 = 
intensity, 4 = light pen, and 8 = blink). 


FEATR 



Mnemonic 


Definition 


7. VALUE 


8. DTA 


9 . N 


10. A 


11. MAINFL 


12. C.NAME 


13. NAMR 


14. PB 


15. RST 


A single integer variable or constant that indicates 
the value or setting is specified for a selected display 
feature. 

Contains the set of data points, one per word, in the 
range 0 to 1023 (Integer). 

Used by GRAPH subprogram to indicate the number of 
points to graph. Also used by TEXT subprogram to 
indicate the number of characters to be displayed. 

An integer variable or constant restricted to the values 

0 and 1. Indicates which axis to increment for GRAPH 

subprogram, 0 = increment X, set Y to data values, 

1 = increment Y, set X to data values. 

Similar to PNAME, the value of MAINFL represents the 
first array element of the dimensioned Integer array 
specified by the user for storing main display file 
commands. MAINFL is represented as a subscripted 
integer variable, it contains the length of the file and 
is the variable by which the file is referenced. 

An integer variable that identifies the location or 
first location which contains the display command(s) 
generated by the call in which CNAME is an output argu¬ 
ment. 

An integer which represents the contents of the name 
register at the time of a light pen hit (restricted to 
values ranging from 0 to 127). 

A six-element integer array which will contain a logical 
• T‘, or ,F, for each of the six push buttons. 

This variable, restricted to the integer values of 1 
and 0, indicates whether the hardware SAVE/RESTORE 
option is to be used when copying subpicture files. 

The value 0 indicates that the SAVE/RESTORE option is 
not to be used; the value 1 indicates that it is to be 
used. 
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APPENDIX B 


DISPLAY INSTRUCTION GROUPS 
Generated By 

GRAPHICS SUBPROGRAM CALLS 


NUMBER OF 

SUBPROGRAM CALL COMMANDS 


LINE 

PLOT (0, . . . 
REPLOT (0, . . 


TEXT 

PLOT(3,.. 
REPLOT(3, 


COPY 

PLOT(0, . . 
REPLOT(0, 


PRAMTR 
PLOT(2,. 
REPLOT(2 


SETPT 

RSETPT 











COMMANDS GENERATED 



If one of the eight basic directions 


VN1INCR 


If random vector option is used: 

SVX! DELTAX 
SVY! DELTAY 


If not one of the above, required line 
is approximated with a series of basic 
vectors: 

SKP 

(C0UNT=N+2) 

VI 

V2 


CHARS* .+2 
DUMP .+2 

(FULL 15-BIT ADDRESS) 


When SAVE/RESTORE is not used: 

DJMS* .+2 
DUMP o+2 

(FULL 15-BIT ADDRESS) 


When SAVE/RESTORE is specified: 
SAVE o+4 

DJMS* .+2 

DJMP o+3 

(FULL 15-BIT ADDRESS) 
(STATUS) 

RSTR .-I 


Adds from one to four parameter words 
to the display file, depending on the 
type of argument list used. 


Adds N graph plot commands to the dis¬ 
play file, where N is equal to the 
number of points in the data set: 


GY1Y1 
GY! Y2 


GYJYN 


GX'Xl 

GXIX2 


GXIXN 






































APPENDIX C 


MACRO EXPANSION OP GRAPHICS SUBPROGRAM CALLS 


Subpicture Routines 


LINE GRAPH 


.GLOBAL 

LINE 

.GLOBL 

GRAPH 

JMS* 

LINE 

JMS* 

GRAPH 

JMP 

.+5 

JMP 

.+5 

. DSA 

DELTAX 

. DSA 

DTA 

. DSA 

DELTAY 

o DSA 

N 

• DSA 

INT 

.DSA 

A 

[.DSA 

PNAME ] 

[.DSA 

PNAME ] 


TEXT 


BLANK 


.GLOBL 

TEXT 

.GLOBL 

BLANK 

JMS* 

TEXT 

JMS* 

BLANK 

JMP 

.+4 

JMP 

.4-2 

.DSA 

STR 

.DSA 

PNAME 

.DSA 

N 



[.DSA 

PNAME ] 

UNBLNK 


COPY 


.GLOBL 

UNBLNK 


JMS* 

UNBLNK 

.GLOBL 

COPY 

JMP 

. + 2 

JMS* 

COPY 

.DSA 

PNAME 

JMP 

. +4 



.DSA 

RST 

CIRCLE 


.DSA 

PNAME1 



[.DSA 

PNAME ] 

.GLOBL 

CIRCLE 

JMS* 

CIRCLE 



JMP 

.+6 

PRAMTR 


.DSA 

R 



• DSA 

THETA 

.GLOBL 

PRAMTR 

.DSA 

GAMMA 

JMS* 

PRAMTR 

.DSA 

DEG 

JMP 

. +N 

.DSA 

PNAME 

.DSA 

FEATR 



.DSA 

VALUE 

ROTATE 


[.DSA 

PNAME ] 


where N= 

2+ (Number of Features 

.GLOBL 

ROTATE 

specified)+1 if PNAME 

JMS 

ROTATE 

is 

given 

JMP 

.4-12 



.DSA 

I STR 



.DSA 

IA 



.DSA 

IB 



.DSA 

IC 



.DSA 

X 



.DSA 

Y 



.DSA 

Z 



.DSA 

SINA 



.DSA 

CSA 
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Input Routines 


LTORPB TRACK 


.GLOBL 

LTORPB 

.GLOBL 

TRACK 

JMS* 

LTORPB 

JMS* 

TRACK 

JMP 

.+6 

JMP 

.+5 

.DSA 

IX 

= DSA 

IX 

.DSA 

IY 

.DSA 

IY 

.DSA 

NAMR 

.DSA 

IOPT 

.DSA 

PB 

.DSA 

IARRAY 

.DSA 

IWICH 



DAC 

I 






Relocating 

Routines 


1 


DYLINK 


.GLOBL 

DYSET 


.GLOBL 

DYLINK 

JMS* 

DYSET 


JMS* 

DYLINK 

JMP 

2*N+.+l 


JMP 

2*N+.+1 

.DSA 

PNAME 


.DSA 

PNAME1 

.DSA 

ASCII 


.DSA 

ASCII1 

.DSA 

PNAMEN 


.DSA 

PNAMEN 

.DSA 

ASCIIN 


.DSA 

ASCIIN 


(where n 

= number 


(where 


of files) 


Main Display File Routines 


DINIT 


SETPT 


.GLOBL DINIT 

JMS * DINIT 

JMP . + 2 

.DSA MAINFL 


DCLOSE 

.GLOBL DCLOSE 

JMS* DCLOSE 


.GLOBL SETPT 

JMS* SETPT 

JMP .+4 

.DSA X 

.DSA Y 

[. DSA CNAME ] 
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= number 
of files) 



Main Display File Routines (Cont.) 


PLOT a COPY 


REPLOT 


.GLOBL 

PLOT 

.GLOBL 

REPLOT 

JMS * 

PLOT 

JMS* 

REPLOT 

JMP 

.+5 

JMP 

. + 5 

. DSA 

(0 

.DSA 

10 

. DSA 

RST 

.DSA 

RST 

.DSA 

PNAME 

.DSA 

PNAME 

[.DSA 

CNAME] 

.DSA 

CNAME 



DAC 

1/ if used as function 

PLOT a LINE 




.GLOBL 

PLOT 

REPLOT a : 

LINE 

JMS* 

PLOT 

.GLOBL 

REPLOT 

JMP 

.+6 

JMS* 

REPLOT 

.DSA 

(1 

JMP 

. + 6 

.DSA 

DELTAX 

.DSA 

(1 

.DSA 

DELTAY 

.DSA 

DELTAX 

.DSA 

INT 

.DSA 

DELTAY 

[ .DSA 

CNAME] 

.DSA 

INT 



.DSA 

CNAME 



DAC 

1/ if used as function 

PLOT a PRAMTR 



.GLOBL 

PLOT 



JMS* 

PLOT 

REPLOT a : 

PRAMTR 

JMP 

.+5 

.GLOBL 

REPLOT 

.DSA 

(2 

JMS* 

REPLOT 

.DSA 

FEATR 

JMP 

.+5 

.DSA 

VALUE 

.DSA 

(2 

[ .DSA 

CNAME] 

.DSA 

FEATR 



.DSA 

VALUE 



.DSA 

CNAME 

PLOT a TEXT 

string 

DAC 

1/ if used as function 

.GLOBL 

PLOT 



JMS* 

PLOT 



JMP 

.+5 

REPLOT a ' 

TEXT string 

.DSA 

(3 

.GLOBL 

REPLOT 

.DSA 

STR 

JMS* 

REPLOT 

.DSA 

N 

JMP 

. +5 

[ .DSA 

CNAME] 

.DSA 

(3 



.DSA 

STR 



.DSA 

N 

DELETE 


.DSA 

CNAME 

.GLOBL 

DELETE 

DAC 

1/ if used as function 

JMS* 

DELETE 



JMP 

. +2 



.DSA 

CNAME 

RSETPT 


DAC 

1/ if used as 

function .GLOBL 

RSETPT 



JMS* 

RSETPT 



JMP 

.+4 



.DSA 

X 



.DSA 

Y 



.DSA 

CNAME 



DAC 

1/ if used as function 
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APPENDIX D 


CONDITIONAL ASSEMBLY OF GRAPHICS SUBPROGRAMS 


For VT15 configurations that include the Arbitrary Vector 
Option, the Graphics Subprogram Package (VTPRIM) can be 
conditionally assembled to eliminate coding required for 
line approximation. This procedure saves approximately 
174g locations. The standard procedure for conditional 
assembly may be followed; it is only necessary to define 
a value for the variable ARBVEC when assembling VTPRIM SRC. 


WARNING 

In writing MACRO routines, the exclamation point 
(1) must not be used in memory reference type in¬ 
structions to separate the Op-code and address 
fields. The symbol I used in this manner causes 
the contents of the Op-code and address fields to 
be OR'd together resulting in an erroneous 15-bit 
address. 


D-l 




INDEX 


A (mnemonic definition), A-2 
Absolute beam locations , 3-4, 3-9 
ADSS Users manuals, 1-3 
ALT MODE in TEXT array, 2-5 
Angle of rotation, 2-14 
API, 6-1 

Arcs, measurement of, 2-13 
Arguments, 2-3 
Array references, 1-2 
Arrays, 2-1, 3-1, 4-3, A-l 
Array storage, 2-2 
Array, TEXT, 2-5 
ASCII, 2-5, 5-1 


Beam intensified, 2-3 
BLANK subroutine, 2-1, 2-10 
BLANK/UNBLANK subroutine, 2-12 
Blink setting, 2-1 


CALL TRACK arguments, 4-4 
Change display commands, 3-8 
CIRCLE subroutine, 2-12 
Clock pulses, 8-1 
.CLOSE macro 

LK35 keyboard, 7-4 
system I/O device handler, 6-5 
writing tablet, 8-5 
CNAME, 3-2 

mnemonic definition of. A™2 
Conditional assembly of graphics 
subroutines, D-l 
Constants, 2-3 

Control characters recognized by 
LKA, 7-5 

Controls, VT-15 display console, 9-1 
COPY subroutine, 2-1, 2-6, 3-5 
Count of instructions, 3-2 
CRT beam, A-l 
CTRL characters, 7-5 
CTRL X feature, VT-15, 9-2 
differences between ADSS and 
DOS, 9-4 


Dash setting, 2-7 
Data Input mode, VW01, 8-1 
DCLOSE (Display terminate) 
subroutine, 3-4 
DELETE function, 3-2, 3-7 
Definitions of mnemonics, A-l 
DELTAX, 2-4 

mnemonic definition, A-l 
DELTAY, 2-4 

mnemonic definition, A-l 
Device handler for system I/O, 6-1 
DIMENSION statement, 2-2 


DINIT (Display initialize) 
subroutine, 3-3 
Display blanked, 2-12 
Display commands, 3-8 
Display console interaction, 4-1 
Display files, 2-2, 3-3 
Display flags, 6-2, 6-3 
Display instruction groups, B-l 
Display modes, VT-15, 9-2 
Display parameters, 2-7, 2-8, 2-9 
Display routines, 2-1 
Display startup, 6-1 
Distribution of DOS V3A, 1-2 
DOS Users manuals, 1-3 
Drawing on VW01, 8-1 
Draw option, 4-5, 4-6 
DTA (mnemonic definition), A-2 
DYLINK subroutine, 5-2 
DYSET/DYLINK program example, 5-3 
DYSET subroutine, 5-1 

EDITVT program, 9-1 
Escape character, 2-5 
Exclamation operator (!), 2-3 


FEATR (mnemonic definition), A-l 

Filenames, 5-1 

Files, 3-1 

Files, display, 2-2 

File storage, 2-1 

FORTRAN source, 

CIRCLE routine, 2-12 
ROTATE subroutine, 2-14 
e FSTAT macro 

LK35 keyboard, 7-4 

system I/O device handler, 6-6 

writing tablet, 8-5 


GRAPH subroutine, 2-1, 2-10 


HALF ON/OFF monitor command, 9-4 
Hard copy output, 9-2, 9-3 
Hardware configuration, 1-1 
Hardware manuals, 1-3 
Hardware registers, VW01, 8-1 
Hollerith, 2-5 

Horizontal line, generation of a, 
2-3 


IF statement, 4-1 
Inclusive OR function, 2-3 
Initialization IOT, 

system I/O device handler, 6-2 
Initialize main display file, 3-4 
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. INIT macro 

LK35 keyboard, 7-1 
system I/O device handler, 6-1 
writing tablet, 8“2 
Input routines, 4-1 
Instructions, count of, 3-2 
Intensified beam, 2-3 
Intensity setting, 2-1 
Interrupt flags, 6-3 
INT (mnemonic definition), A-l 


Length of subpicture file, 2-1 
Light pen, 4-1 
sensitivity, 2-7 
backing and drawing, 4-2 
LINE subroutine, 2-1, 2-3 
LK35 keyboard device handler (LKA), 
7-1 

LT15 or LT19D controller, 7-1 
LTORB function, 4-1, 4-2 


Macro expansions, c-1 

Main display file initialization, 

3-4 

Main display file routines, 3-1 
MAINFL location, 3-4 
MAINFL (mnemonic definition), A-2 
Manuals for reference, 1-3 
Memory locations, reuse of, 3-3 
Mnemonics, A-l 

Monitor interrupt system, 6-1 
Multiple features, specification of, 
2-8 


Name Register setting, 2-8 
NAMR (mnemonic definition), A—2 
N (mnemonic definition), A-2 


Octagon tracing symbol, 4-2 
Offset setting, 2-8 
OR function, inclusive, 2-3 
Output transfer between devices, 
9-2 

Overflow, 2-3 


Page mode, VT-15, 9-2, 9-3 
PB (mnemonic definition), A-2 
PIC, 6-1 

Plot a control command (PRAMTR), 3-6 

Plot a line, 3-6 

Plot a text string (TEXT), 3-7 

Plot subpicture (COPY), 3-5 

PLOT subroutine, 3-2, 3-5 

Plotting points, VW01, 8-1 

PNAME array, 2—3 

PNAME (mnemonic definition), A-l 


Point plotting, VW01, 8-1 
PRAMTR call statement, 2-8 
PRAMTR subroutine, 2-1, 2-7, 3-6 
Push buttons, 4-1 


Random vector option, 2-4 
Raster unit, 2-3 
oREAD macro 

LK35 keyboard, 7-2, 7-3 
system I/O device handler, 6-3 
writing tablet, 8-3 
Relative displacement, 3-4 
Relocating routines, 5-1 
REPLOT function, 3-8 
Reposition the beam, 3-6 
Restore display parameters, 2-6 
Restrictions to subpicture routines, 
2-3 

Rotate setting, 2-8 

ROTATE subroutine, 2-14 

Routines, 2-1 

RSETPT function, 3-9 

RST (mnemonic definition), A-2 


Sample DYSET/DYLINK program, 5-3 
Sample, sine wave program, 2-11 
Sample TRACK program 
FORTRAN, 4-3 
MACRO-15, 4-7 
SAVE/RESTORE option, 2-6 
Scale setting, 2-7 
Scope phosphor, 2-1 
Scroll mode, VT-15, 9-2, 9-3 
Set initial conditions (SIC), 6-2 
SETPT (Set point) subroutine, 3-2, 
3-4 

Setup commands, EDITVT, 9—1 
Sine wave program example, 2-11 
Single point mode of operation, 
VW01, 8-1 

Sloped line, generation of a, 2-4 
Soft copy output, 9-2, 9-3 
Software manuals, 1-3 
Spark pen, 8-1 

Square, generation of a, 2-2 
Start up display, 6-1 
Status registers, 6-2, 6-3 
Storage of files, 2-1, 2-2, 3-1 
STR (mnemonic definition), A-l 
Subpicture routines, 2-1 
Sync feature, 2-8 
System I/O device handler, 6-1 


TEXT subroutine, 2-1, 2-5, 3-7 
Text/display edit functions, 9-1 
3-dimensional figures, 2-14 
Tracking symbol, 4-2 
TRACK macro calling sequence, 4-5 
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TRACK program sample 
FORTRAN, 4-3 
MACRO”" 15 , 4-1 
TRACK subroutine, 4-2 


UNBLNK subroutine, 2-1, 2-12 


VALUE (mnemonic definition), A-2 
Variables , 2-2 
Vectors, 2-4 

Version numbers for modules, 1-2 
Vertical line, generation of a, 2-4 
VT15 device handler (VTA), 3-3, 8-2 
VT15 processor, 1-2 
VT ON/OFF monitor commands, 9-3 
VTPRIM (Graphic subprogram package), 
D-l 

VWA device handler, 8-2 

VW01 writing tablet handler, 8-1 


Wait function (LTORPB), 4-2 
„ WAIT macro 

LK35 keyboard, 7-3 
system I/O device handler, 6-4 
writing tablet, 8-4 
„WAITR macro 

LK35 keyboard, 7-3 
system I/O device handler, 6-5 
writing tablet 8-4 
a WRITE macro 

system I/O device handler, 6-4 
Writing tablet, 8-1, 8-2 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS , MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products* Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections* 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi¬ 
cally* For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 

P. 0. Box F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital's software should be reported 
to a Software Support Specialist* A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 


Reading, England 
Paris, France 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 


Digital Equipment Corporation 

Software Distribution Center 

146 Main Street 

Maynard, Massachusetts 01754 

Outside of the United States, 
Digital Field Sales Office or 


Digital Equipment Corporation 

Software Distribution Center 

1400 Terra Bella 

Mountain View, California 94043 


orders should be directed to the nearest 
representative. 


USERS SOCIETY 


DECUS, Digital Equipment Computer Users Society, maintains a user ex¬ 
change center for user-written programs and technical application in¬ 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS Europe 

Digital Equipment Corporation International 
P.O, Box 340 
1211 Geneva 26 
Switzerland 








READER'S COMMENTS 


VT-15 Graphics Software 
System? Programming Manual 
DEC-15-GVTPA-A-D 

Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback -- your critical evaluation of 
this manual. 


Please comment on this manual's completeness, accuracy, organization, usability and read¬ 
ability. 



Other comments? 
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